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INITIAL INSPECTION 



WARRANTY 



PRODUCT ASSISTANCE 



MAINTENANCE 

AGREEMENTS 



GENERAL INFORMATION 



It is recommended that the shipment be thoroughly inspected im- 
mediately upon delivery to the purchaser. All material in the 
container should be checked against the enclosed Packing List. 
LeCroy cannot accept responsibility for shortages in comparison 
with the Packing List unless notified promptly. If the shipment is 
damaged in any way, please contact the Customer Service Depart- 
ment or local field office immediately. 

LeCroy warrants its oscilloscope products to operate within specifi- 
cations under normal use for a period of two years from the date of 
shipment. Spares, replacement parts and repairs are warranted for 
90 days. The instrument’s firmware is thoroughly tested and 
thought to be functional, but is supplied “as is” with no warranty of 
any kind covering detailed performance. Products not manufac- 
tured by LeCroy are covered solely by the warranty of the original 
equipment manufacturer. 

In exercising this warranty, LeCroy will repair or, at its option, 
replace any product returned to the Customer Service Department 
or an authorized service facility within the warranty period, pro- 
vided that the warrantor’s examination discloses that the product 
is defective due to workmanship or materials and that the defect 
has not been caused by misuse, neglect, accident or abnormal con- 
ditions or operation. 

The purchaser is responsible for transportation and insurance 
charges for the return of products to the servicing facility. LeCroy 
will return all in-warranty products with transportation prepaid. 

This warranty is in lieu of all other warranties, expressed or im- 
plied, including but not limited to any implied warranty of 
merchantability, fitness, or adequacy for any particular purpose or 
use. LeCroy shall not be liable for any special, incidental, or con- 
sequential damages, whether in contract or otherwise. 

Answers to questions concerning installation, calibration, and use 
of LeCroy equipment are available from the Customer Service 
Department, 700 Chestnut Ridge Road, Chestnut Ridge, New 
York 10977-6499, U.S.A., tel. (914)578-6061, and 2, rue du 
Pre-de-la-Fontaine, 1217 Meyrin 1, Geneva, Switzerland, tel. 
(41)22/719 21 11, or your local field engineering office. 

LeCroy offers a selection of customer support services. Mainte- 
nance agreements provide extended warranty and allow the 
customer to budget maintenance costs after the initial two year 
warranty has expired. Other services such as installation, training, 
enhancements and on-site repair are available through specific 
Supplemental Support Agreements. 
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General Information 



DOCUMENTATION 

DISCREPANCIES 



SERVICE PROCEDURE 



RETURN PROCEDURE 



LeCroy is committed to providing state-of-the-art instrumenta- 
tion and is continually refining and improving the performance of 
its products. While physical modifications can be implemented 
quite rapidly, the corrected documentation frequently requires 
more time to produce. Consequently, this manual may not agree in 
every detail with the accompanying product. There may be small 
discrepancies in the values of components for the purposes of 
pulse shape, timing, offset, etc., and, occasionally, minor logic 
changes. Where any such inconsistencies exist, please be assured 
that the unit is correct and incorporates the most up-to-date cir- 
cuitry. In a similar way the firmware may undergo revision when 
the instrument is serviced. Should this be the case, manual up- 
dates will be made available as necessary. 

Products requiring maintenance should be returned to the Cus- 
tomer Service Department or authorized service facility. LeCroy 
will repair or replace any product under warranty at no charge. 
The purchaser is only responsible for transportation charges. 

For all LeCroy products in need of repair after the warranty pe- 
riod, the customer must provide a Purchase Order Number before 
repairs can be initiated. The customer will be billed for parts and 
labor for the repair, as well as for shipping. 

To determine your nearest authorized service facility, contact the 
Customer Service Department or your field office. All products 
returned for repair should be identified by the model and serial 
numbers and include a description of the defect or failure, name 
and phone number of the user, and, in the case of products re- 
turned to the factory, a Return Authorization Number (RAN). 
The RAN may be obtained by contacting the Customer Service 
Department in New York, tel. (914)578-6061, in Geneva, tel. 
(41)22/719 21 11, or your nearest sales office. 

Return shipments should be made prepaid. LeCroy will not accept 
C.O.D. or Collect Return Shipments. Air-freight is generally rec- 
ommended. Wherever possible, the original shipping carton 
should be used. If a substitute carton is used, it should be rigid and 
be packed such that the product is surrounded with a minimum of 
four inches of excelsior or similar shock-absorbing material. In 
addressing the shipment, it is important that the Return Authoriza- 
tion Number be displayed on the outside of the container to ensure 
its prompt routing to the proper department within LeCroy. 
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ABOUT REMOTE CONTROL 



Two modes of operation are available in the oscilloscope. The in- 
strument may be operated either manually, by using the 
front-panel controls, or remotely by means of an external control- 
ler (which is usually a computer, but may be a simple terminal) . 
This Remote Control Manual describes how to control the oscillo- 
scope in the remote mode. For explanations on how to manually 
set front-panel controls, refer to the Operator’s Manual. 

The oscilloscope is remotely controlled via either the GPIB (Gen- 
eral Purpose Interface Bus) or the RS-232-C communication 
ports. Whenever the rear-panel GPIB address switches are set be- 
tween 0 and 30, control is via GPIB; when they are at 31 or above, 
control is via RS-232-C. The instrument can be fully controlled in 
remote mode. The only actions which cannot be performed re- 
motely are switching on the instrument or setting the remote 
address. 

This section introduces the basic remote control concepts which 
are common to both RS-232-C and GPIB. It also presents a brief 
description of remote control messages. 

Sections 3 and 4 explain how to send program messages over the 
GPIB or the RS-232-C interfaces, respectively. Section 5 alpha- 
betically lists all the remote control commands. Section 6 is a 
detailed description and tutorial of the transfer and format of 
waveforms, whereas Section 7 explains the use of status bytes for 
error reporting. Appendix A shows some complete programming 
examples. Appendix B contains a printout of a waveform tem- 
plate. 



GPIB IMPLEMENTATION 

STANDARD The remote commands conform to the GPIB IEEE 488.2 stan- 

dard 1 . This standard may be seen as an extension of the 
IEEE 488.1 standard which dealt mainly with electrical and me- 
chanical issues. The IEEE 488.2 recommendations have also 
been adopted for RS-232-C communications whenever applica- 
ble. 



PROGRAM MESSAGES To remotely control the oscilloscope the controller must send pro- 
gram messages which conform to precise format structures. The 
instrument will execute all program messages which are in the cor- 
rect form and ignore those where errors are detected. 



1. ANSI/IEEE Std. 488.2-1987, “IEEE Standard Codes, Formats, Protocols, and Common Commands”, The 
Institute of Electrical and Electronics Engineers Inc., 345 East 47th Street, New York, NY 10017, USA. 
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2 About Remote Control 



Warning or error messages are normally not reported by the instru- 
ment, unless the controller explicitly examines the relevant status 
register, or if the status enable registers have been set in such a way 
that the controller can be interrupted when an error occurs. The 
status registers are explained in Section 7. 

During the development of the control program it is possible to 
observe all remote control transactions, including error messages, 
on an external monitor connected to the RS-232-C port. Refer to 
the command “COMM_HELP” for further details. 



COMMANDS 

AND QUERIES Program messages consist of one or several commands or queries. 

A command directs the instrument to change its state, e.g. to 
change its time base or vertical sensitivity. A query asks the instru- 
ment about its state. Very often, the same mnemonic is used for a 
command and a query, the query being identified by a <?> after 
the last character. 

For example, to change the time base to 2 msec/div, the controller 
should send the following command to the instrument 

TIME_DIV 2 MS 

To ask the instrument about its time base, this query should be 
sent 

TIME_DIV? 

A query causes the instrument to send a response message. The 
control program should read this message with a “read” instruc- 
tion to the GPIB or RS-232-C interface of the controller. The 
response message to the query above might be 

TIMEJDIV 10 NS 

The portion of the query preceding the question mark is repeated 
as part of the response message. If desired, this text may be sup- 
pressed with the command “COMM_HEADER”. 

Depending on the state of the instrument and the computation to 
be done, the controller may have to wait up to several seconds for 
a response. Command interpretation does not have priority over 
other oscilloscope activities. It is therefore judicious to set the con- 
troller IO timeout conditions to 3 or more seconds. In addition, it 
must be remembered that an incorrect query message will not gen- 
erate a response message. 
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About Remote Control 2 



LOCAL AND REMOTE 
STATE 



PROGRAM MESSAGE 
FORM 



As a rule, remote commands are only executed by the instrument 
when it is in the REMOTE state, whereas queries are always ex- 
ecuted. A few commands which don’t affect the state of the front 
panel are also executed in LOCAL (refer to the beginning of Sec- 
tion 5 for a list of these commands) . When the instrument is in 
REMOTE, all front-panel controls are disabled, except the left- 
hand menu buttons, the intensity controls (which can be disabled 
with the command “INTENSITY”) and the LOCAL button 
(which can be disabled by setting the instrument to LOCAL 
LOCKOUT) . For an explanation on how to set the instrument to 
LOCAL, REMOTE or LOCAL LOCKOUT, refer to Section 3 for 
GPIB and to Section 4 for RS-232-C. 



An instrument is remotely controlled with program messages 
which consist of one or several commands or queries, separated by 
semicolons <;> and ended by a terminator: 

<command/query>; ;<command/query> <terminator> 

Upper and/or lower case characters can be used for program mes- 
sages. 

The instrument does not decode an incoming program message 
before a terminator has been received (exception: if the program 
message is longer than the 256 byte input buffer of the instrument, 
the oscilloscope starts analyzing the message when the buffer is 
full) . The commands or queries are executed in the order in which 
they are transmitted. 

In GPIB mode, the following are valid terminators: 

<NL> New-line character (i.e. the ASCII new-line 

character, whose decimal value is 10). 

<NL> <EOI> New-line character with a simultaneous <EOI> 
signal. 

<EOI> <EOI> signal together with the last character of 

the program message. 

Note: The <EOI> signal is a dedicated GPIB interface line which 
can be set with a special call to the GPIB interface driver . Refer to 
the GPIB interface manufacturer's manual and support pro- 
grams . 

The <NL> <EOI> terminator is always used in response messages 
sent by the instrument to the controller. 

In RS-232-C, the terminator may be defined by the user with the 
command “COMM_RS232”. The default value is <CR>, i.e. the 
ASCII carriage return character, the decimal value of which is 13. 
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^ About Remote Control 



Examples 



COMMAND/QUERY 

FORM 



Example 



Header 



GRID DUAL This program message consists of a 

single command which instructs the 
instrument to display a dual grid. 
The terminator is not shown since it 
is usually automatically added by 
the interface driver routine which 
writes to the GPIB (or RS-232). 

BWL ON; DISPLAY OFF; DATE? 

This program message consists of 
two commands, followed by a 
query. They instruct the instrument 
to turn on the bandwidth limit, turn 
off the display, and then ask for the 
current date. Again, the terminator 
is not shown. 



The general form of a command or a query consists of a command 
header <header> which is optionally followed by one or several 
parameters <data> separated by commas: 

<header>[?] <data>, ...,<data> 

The notation [?] shows that the question mark is optional (turning 
the command into a query) . The detailed listing of all commands 
in Section 5 indicates which commands may also be queries. 
There is a space between the header and the first parameter. 
There are commas between parameters. 

DATE 15, OCT, 1989, 13, 2 1,1 6 

This command instructs the oscillo- 
scope to set its date and time to 15 
OCT 1989, 13:21:16. The com- 
mand header “DATE” indicates 
the action, the 6 data values specify 
it in detail. 

The header is the mnemonic form of the operation to be per- 
formed by the oscilloscope. All command mnemonics are listed in 
alphabetic order in Section 5. 

The majority of the command/query headers have a long form for 
optimum legibility and a short form for better transfer and decod- 
ing speed. The two forms are fully equivalent and can be used 
interchangeably. For example, the following two commands for 
switching to the automatic trigger mode are fully equivalent: 

TRIG MODE AUTO and TRMD AUTO 
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About Remote Control 2 



Header path 



Example 



Data 



Some command/query mnemonics are imposed by the IEEE 
488.2 standard. They are standardized so that different instru- 
ments present the same programming interface for similar 
functions. All these mnemonics begin with an asterisk <*>, e.g. 
the command “ *RST” is the IEEE 488.2 imposed mnemonic for 
resetting the instrument, whereas “*TST?” instructs the instru- 
ment to perform an internal self-test and to report the outcome. 



Some commands or queries apply to a sub-section of the oscillo- 
scope, e.g. a single input channel or a trace on the display. In such 
cases, the header must be preceded by a path name that indicates 
the channel or trace to which the command applies. The header 
path normally consists of a 2-letter path name followed by a colon 
<:> which immediately precedes the command header. 

Usually one of the waveform traces can be specified in the header 
path (refer to the individual commands listed in Section 5 for de- 
tails on which values apply to a given command header): 



Cl, C2 
C3, C4 
MC, MD 
FE, FF 
EA, EB 
EX, EX 10 



Channels 1 and 2 

Channels 3 and 4 (in 4-channel instruments) 

Memory C and D 

Function E and F 

Expand A and B 

External trigger 



Cl:OFST -300 MV Set the offset of Channel 1 to 

-300 mV 

Header paths need only be specified once. Subsequent commands 
whose header destination is not indicated are assumed to refer to 
the last defined path. For example, the following commands are 
identical: 



C2:VDIV?; C2:OFST? What is the vertical sensitivity and 

the offset of channel 2? 

C2:VDIV?; OFST? Same as above, without repeating 

the path. 



Whenever a command/query uses additional data values, they are 
expressed in terms of ASCII characters. There is a single excep- 
tion: the transfer of waveforms with the command/query 
“WAVEFORM”, where the waveform may be expressed as a se- 
quence of binary data values. Refer to Section 6 for a detailed 
explanation of the format of waveforms. 

ASCII data can have the form of character, numeric, string or 
block data. 
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2 About Remote Control 



Character data 



Numeric Data 



These are simple words or abbreviations for the indication of a 
specific action. 

BANDWIDTH_LIMIT ON The data value “ON” indicates that 

the bandwidth limit should be 
turned on, rather than off. 

In some commands, where as many as a dozen different parame- 
ters can be specified, or where not all parameters apply at the same 
time, the format requires pairs of data values. The first one names 
the parameter to be modified and the second gives its value. Only 
those parameter pairs to be changed need to be indicated. 

HARDCOPY_SETUP DEV, HP7470A, PORT, GPIB.PSIZE.A4 

Three pairs of parameters are spe- 
cified. The first specifies the device 
as the H7470A plotter (or compat- 
ible) , the second indicates the 
GPIB port and the third requests 
the A4 format for paper size. While 
the command “ H ARDCOPY_SET- 
UP” allows many more parameters, 
they are either not relevant for plot- 
ters or they are left unchanged. 

The numeric data type is used to enter quantitative information. 
Numbers can be entered as integers, as fractions or in exponential 
representation. 

EA;VPOS -5 Move the displayed trace of Expand A down- 
wards by 5 divisions. 

C2:OFST 3.56 Set the DC offset of Channel 2 to 3.56 V. 

TDIV 5.0E-6 Adjust the time base to 5 p.sec/div. 

Note: Numeric values may be followed by multipliers and units, 
modifying the value of the numerical expression. The following 
mnemonics are recognized : 
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About Remote Control 2 



String Data 



Block Data 



RESPONSE 

FORM 



EX 


1E18 


Exa- 


PE 


1E15 


Peta- 


T 


1E12 


Tera- 


G 


1E9 


Giga- 


MA 


1E6 


Mega- 


K 


1E3 


kilo- 


M 


IE-3 


milli- 


U 


IE-6 


micro- 


N 


IE-9 


nano- 


PI 


IE-12 


pico- 


F 


IE-15 


femto- 


A 


IE-18 


atto- 



For example, there are many ways of setting the time base of the 
instrument to 5 y.sec/div: 

TDIV 5E-6 
TDIV 5 US 



TDIV 5000 NS 
TDIV 5000E-3 US 

This data type enables the transfer of a (long) string of characters 
as a single parameter. String data are formed by simply enclosing 
any sequence of ASCII characters between simple or double 
quotes. 

MESSAGE ‘Connect probe to point J3’ 

The instrument displays this message in the Message field above 
the grid. 

These are binary data values coded in hexadecimal ASCII, i.e. 
4-bit nibbles are translated into the digits 0,...9, A,...F and trans- 
mitted as ASCII characters. They are only used for the transfer of 
waveforms (command “WAVEFORM”) and of the instrument 
configuration (command “PANEL_SETUP”) 



Exponential notation, without any 
suffix. 

Suffix multiplier “U” for IE-6, 
with the (optional) suffix “S” for 
seconds. 



MESSAGE 

The instrument sends a response message to the controller, as an 
answer to a query. The format of such messages is the same as that 
of program messages, i.e. individual responses in the format of 
commands, separated by semicolons <;> and ended by a termina- 
tor. They can be sent back to the instrument in the form in which 
they are received, and will be accepted as valid commands. In 
GPIB response messages, the <NL> <EOI> terminator is always 
used. 

For example, if the controller sends the program message: 

TIME_DIV?;TRIG_MODE NORM ;C1: COUPLING? (terminator 
not shown) 
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the instrument might respond as follows: 

TIME_DIV 50 NS ;C1: COUPLING D50 (terminator not shown) 

The response message only refers to the queries, i.e. 
“TRIG_MODE” is left out. If this response is sent back to the 
instrument, it is a valid program message for setting its time base to 
50 nsec/div and the input coupling of Channel 1 to 50 fl. 

Whenever a response is expected from the instrument, the control 
program must instruct the GPIB or RS-232-C interface to read 
from the instrument. If the controller sends another program mes- 
sage without reading the response to the previous one, the 
response message in the output buffer of the instrument is dis- 
carded. 

The instrument uses somewhat stricter rules for response messages 
than for the acceptance of program messages. Whereas the con- 
troller may send program messages in upper or lower case 
characters, response messages are always returned in upper case. 
Program messages may contain extraneous spaces or tabs (white 
space), response messages do not. Whereas program messages 
may contain a mixture of short and long command/query headers, 
response messages always use short headers as a default. However, 
the instrument can be forced with the command 
“COMM_HEADER” to use long headers or no headers at all. If 
the response header is omitted, the response transfer time is mini- 
mized, but such a response could not be sent back to the 
instrument again. In this case suffix units are also suppressed in the 
response. 

If the trigger slope of Channel 1 is set to negative, the query 
“C1.TRSL7” could yield the following responses: 

Cl:TRIG_SLOPE NEG header format: long 

C1:TRSL NEG header format: short 

NEG header format: off 

Waveforms which are obtained from the instrument using the 
query “WAVEFORM?” constitute a special kind of response mes- 
sage. Their exact format can be controlled with the commands 
“COMM_FORMAT” and “ COMM_ORDER" , as explained in 
Section 6. 
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GPIB OPERATION 



GPIB STRUCTURE 



INTERFACE 

CAPABILITIES 



This section describes how to remotely control the oscilloscope via 
the GPIB. Topics discussed include interface capabilities, address- 
ing, standard bus commands, and polling schemes. 

The GPIB is like an ordinary computer bus, except that it inter- 
connects independent devices via a cable bus whereas a computer 
has its circuit cards interconnected via a backplane bus. The GPIB 
carries program messages and interface messages: 

• Program messages, often called device-dependent messages, 
contain programming instructions, measurement results, in- 
strument status and waveform data. Their general form is 
described in Section 2. 

• Interface messages manage the bus itself. They perform func- 
tions such as initializing the bus, addressing and unaddressing 
devices and setting remote and local modes. 

Devices on the GPIB can be listeners, talkers, and/or controllers. 
A talker sends program messages to one or more listeners. A con- 
troller manages the flow of information on the bus by sending 
interface messages to the devices. 

The oscilloscope can be a talker or a listener, but not a controller. 
The host computer, however, must be able to act as a listener, 
talker and controller. For details on how the controller configures 
the GPIB for specific functions, refer to the GPIB interface man- 
ufacturer’s manual. 



The interface capabilities of the oscilloscope include the following 
IEEE 488.1 definitions: 

AH1 Complete Acceptor Handshake 

SHI Complete Source Handshake 

L4 Partial Listener Function 

T5 Complete Talker Function 

SRI Complete Service Request Function 

RL1 Complete Remote/Local Function 

DC1 Complete Device Clear Function 

DTI Complete Device Trigger 

PP1 Parallel Polling: remote configurability 

CO No Controller Functions 

E2 Tri-state Drivers 
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^ GPIB Operation 



ADDRESSING 



GPIB SIGNALS 



Data Lines 



Handshake Lines 



Interface Management Lines 



Every device on the GPIB has an address. When the thumbwheel 
address switches on the rear panel of the oscilloscope are set to a 
value between 0 and 30, the instrument can be controlled via 
GPIB. When the switches are set to above 30, the instrument can 
execute talk-only operations on the GPIB, for example driving a 
GPIB plotter. In this case no controller is present and the instru- 
ment is directly connected to the plotter. Addresses above 30 also 
enable the instrument to be controlled via the RS-232-C port. 

The instrument reads the address switches once at power on, or 
when the RESET button on the rear panel is pressed. If the ad- 
dress is changed during operation, the instrument must be 
powered again to enable the new address. The value of the GPIB 
address appears in the menu “Auxiliary Setups”. 

If the oscilloscope is addressed to talk, it will remain configured to 
talk until a universal untalk command (UNT), its own listen ad- 
dress (MLA), or another instrument’s talk address is received. 

Similarly, if the oscilloscope is addressed to listen, it will remain 
configured to listen until a universal unlisten command (UNL), or 
its own talker address (MTA) is received. 

The bus system consists of 16 signal lines and 8 ground or shield 
lines. The signal lines are divided into 3 groups: 

• 8 data lines 

• 3 handshake lines 

• 5 interface management lines 

The eight data lines, usually called DI01 through DI08, carry both 
program and interface messages. Most of the messages use the 
7-bit ASCII code, in which case DI08 is unused. 

These three lines control the transfer of message bytes between 
devices. The process is called a three-wire interlocked handshake 
and it guarantees that the message bytes on the data lines are sent 
and received without transmission error. 

The following five lines manage the flow of information across the 
interface. 

ATN (ATteNtion): The controller drives the ATN line true when 
it uses the data lines to send interface messages such as talk and 
listen addresses or a device clear (DCL) message. When ATN is 
false, the bus is in the data mode for the transfer of program mes- 
sages from talkers to listeners. 

IFC (InterFace Clear): The controller sets the IFC line true to 
initialize the bus. 
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GPIB Operation 3 



I/O Buffers 



IEEE 488,1 
STANDARD 



Device Clear 



REN (Remote ENable): The controller uses this line to place de- 
vices in remote or local program mode. 

SRQ (Service ReQuest): Any device can drive the SRQ line true 
to asynchronously request service from the controller. This is the 
equivalent of a single interrupt line on a computer bus. 

EOI (End Or Identify): This line has two purposes. The talker 
uses it to mark the end of a message string. The controller uses it to 
tell devices to identify their response in a parallel poll (discussed 
later in this section). 

The instrument has a 256-byte input buffer and a 256-byte output 
buffer. An incoming program message is not decoded before a 
message terminator has been received. However, if the input buff- 
er becomes full (because the program message is longer than the 
buffer), the instrument starts analyzing the message. In this case 
data transmission is temporarily halted, and the controller may 
generate a timeout if the limit was set too low. 



MESSAGES The IEEE 488.1 standard specifies not only the mechanical and 
electrical aspects of the GPIB, but also the low-level transfer pro- 
tocol, e.g. it defines how a controller addresses devices, turns 
them into talkers or listeners, resets them or puts them in the re- 
mote state. Such interface messages are executed with the 
interface management lines of the GPIB, usually with ATN true. 

All of these messages (except GET) are executed immediately 
upon reception and not in chronological order with normal com- 
mands. 

Note: In addition to the IEEE 488 .1 interface message standards , 
the IEEE 488.2 standard specifies some standardized program 
messages , i.e. command headers . They are identified with a lead- 
ing asterisk <*> and are listed among the commands in Section 5. 

The command list in Section 5 does not contain any command for 
clearing the input/output buffers or for setting the instrument to 
the remote state. This is because such commands are already spe- 
cified as IEEE 488.1 standard messages. Refer to the GPIB 
interface manual of the host controller as well as to its support 
programs which should contain special calls for the execution of 
these messages. 

The following describes those IEEE 488.1 standard messages 
which go beyond mere reconfiguration of the bus and which have 
an effect on the operation of the instrument. 

In response to a universal Device CLear (DCL) or a Selected De- 
vice Clear message (SDC) , the oscilloscope clears the input/output 
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Group Execute Trigger 



Remote ENable 



Local LOckout 



Go To Local 



buffers, aborts the interpretation of the current command (if any) 
and clears any pending commands. Status registers and status en- 
able registers are not cleared. Although DCL has an immediate 
effect it can take several seconds to execute this command if the 
instrument is busy. 

The Group Execute Trigger message (GET) causes the oscillo- 
scope to arm the trigger system. It is functionally identical to the 
u *TRG” command. 

This interface message is executed when the controller holds the 
Remote ENable control line (REN) true and configures the instru- 
ment as a listener. The REMOTE LED on the front panel lights up 
to indicate that the instrument is set to the remote mode. All the 
front-panel controls are disabled except the left-hand menu but- 
tons, the intensity controls and the LOCAL button. The menu 
indications on the left-hand side of the screen no longer appear 
since menus cannot now be operated manually. Whenever the 
controller returns the REN line to false, all instruments on the bus 
return to LOCAL. Individual instruments can be returned to LO- 
CAL with the Go To Local message (see below). 

As a rule, remote commands are only executed when the instru- 
ment is in the remote state, whereas queries are always executed. 
Local front-panel control may be regained by pressing the LO- 
CAL push button, unless the instrument was placed in the Local 
LOckout (LLO) mode. 

The Local LOckout command (LLO) causes the LOCAL button 
on the front panel of the oscilloscope to be disabled. The LLO 
command can be sent in local or remote mode but only becomes 
effective once the instrument has been set to the remote mode. 

The Go To Local message (GTL) causes the instrument to return 
to the local mode. All front-panel controls become active and the 
menus on the left-hand side of the screen reappear. Thereafter, 
whenever the instrument is addressed as a listener it will be imme- 
diately set to the remote state again. 

Note that a GTL message does not clear the local lockout if it was 
set. Thus, whenever the instrument returns to the remote state the 
local lockout mode would immediately be effective again. 

A command string should not be immediately followed by a GTL 
message. Since GTL is executed at once, the instrument may al- 
ready be returned to the local state before the commands in the 
input buffer are interpreted. Therefore, the instrument may refuse 
to execute them if they require the instrument to be in REMOTE. 
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A safe way to ensure that all commands have been interpreted is to 
append a query (e.g. “ *STB?”) to the command string and to wait 
for the response before sending a GTL. 

InterFace Clear The InterFace Clear message (IFC) initializes the GPIB but has no 

effect on the operation of the oscilloscope. 



PROGRAMMING 

GPIB TRANSFERS To illustrate the GPIB programming concepts a number of exam- 

ples written in BASICA are included in this section. It is assumed 
that the controller is IBM-PC compatible, running under DOS, 
and that it is equipped with a National Instruments 2 GPIB inter- 
face card. GPIB programming with other languages such as C or 
Pascal is quite similar. 

If you use another computer or another GPIB interface, refer to 
the interface manual for installation procedures and subroutine 
calls similar to those described here. 



Configuring the 

GPIB Hardware Check that the GPIB interface is properly installed in the comput- 

er. If it is not, follow the installation instructions of the interface 
manufacturer. In the case of the National Instruments interface, it 
is possible to modify the base I/O address of the board, the DMA 
channel number and the interrupt line setting using switches and 
jumpers. In our program examples, they are assumed to be left in 
their default positions. 

Connect the oscilloscope to the computer with a GPIB interface 
cable. Set the GPIB address on the rear of the instrument to the 
required value. The program examples assume that it is set to 4, 
Remember to power the instrument up after setting the GPIB ad- 
dress. 



Configuring the 

GPIB Driver Software The host computer needs an interface driver which handles the 

transactions between the user’s programs and the interface board. 

In the case of the National Instruments interface, the installation 

procedure: 

• copies the GPIB handler GPIB.COM into the boot directory. 

• modifies the DOS system configuration file CONFIG.SYS to 
declare the presence of the GPIB handler. 

• creates a sub-directory GPIB-PC. 

• installs in GPIB-PC a number of files and programs which are 
useful for testing and reconfiguring the system, and for writing 
user programs. 



2. National Instruments Corporation, 12109 Technology Boulevard, Austin, Texas 78727 
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Simple Transfers 



The following files in the sub-directory GPIB-PC are of particular 
use: 

IBIC.EXE allows interactive control of the GPIB via functions en- 
tered at the keyboard. Use of this program is highly recommended 
to anyone who is not familiar with GPIB programming or with the 
oscilloscope's remote commands. An example of the use of 
IBIC.EXE is shown in Appendix A. 

DECL.BAS is a declaration file that contains code to be included 
at the beginning of any BASICA application program. Simple 
application programs can be quickly written by appending the 
user's instructions to DECL.BAS and executing the complete file. 

IBCONF.EXE is an interactive program which allows inspection 
or modification of the current settings of the GPIB handler. To run 
IBCONF.EXE, refer to the National Instruments user's manual. 

In the program examples in this section, it is assumed that the 
National Instruments GPIB driver GPIB.COM is in its default 
state, i.e. that the user has not modified it with IBCONF.EXE. 
This means that the interface board can be referred to by the sym- 
bolic name 'GPIBO' and that devices on the GPIB bus with 
addresses between 1 and 16 can be called by the symbolic names 
’DEVI' to ’DEV16’. 

Note: If you have a National Instruments PC2 interface card rath- 
er than PC2A, you must run IBCONF to declare the presence of 
this card rather than the default PC2A. 

For a large number of remote control operations it is sufficient to 
use just 3 different subroutines (IBFIND, IBRD and IBWRT) pro- 
vided by National Instruments. The following complete program 



reads the time- 
the terminal: 


-base setting of the oscilloscope and displays it on 


1-99 


<DECL.BAS> 


100 


DEV$=”DEV4” 


110 


CALL IBFIND (DEV$,SCOPE%) 


120 


CMD$=”TDIV?” 


130 


CALL IBWRT(SCOPE%,CMD$) 


140 


CALL IBRD(SCOPE%,RD$) 


150 


PRINT RDS 


160 


END 
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Explanation 



Lines 1-99 are a copy of the file DECL.BAS supplied by National 
Instruments. The first 6 lines are required for the initialization of 
the GPIB handler. The other lines are declarations which may be 
useful for larger programs, but are not really required code. The 
sample program above only uses the strings CMD$ and RD$ which 
are declared in DECL.BAS as arrays of 255 characters. 

Note: DECL.BAS requires access to the file BIB.M during the 
GPIB initialization. BIB.M is one of the files supplied by National 
Instruments, and it must exist in the directory currently in use. 

Note: The first 2 lines of DECL.BAS each contain a string 
"XX XXX" which must be replaced by the number of bytes which 
determine the maximum workspace for BASIC A (computed by 
subtracting the size of BIB.M from the space currently available in 
BASIC A). For example, if the size of BIB.M is 1200 bytes and 
when BASIC A is loaded it reports “60200 bytes free", you should 
replace “XXXXX" by the value 59000 or less. 

Lines 100 and 110 open the device “DEV4” and associate with it 
the descriptor “ SCOPE%” . All I/O calls from now on will refer to 
“SCOPE%” . The default configuration of the GPIB handler recog- 
nizes “DEV4” and associates with it a device with GPIB address 4. 
If you want to use another GPIB address between 1 and 16, use 
the string “DEVx” with x = 1...16. If you want to use another 
name, run IBCONF.EXE to declare this name to the handler. 

Lines 120 and 130 prepare the command string TDIV? and trans- 
fer it to the instrument. The command instructs it to respond with 
the current setting of the time base. 

Line 140 reads the response of the instrument and places it into 
the character string RD$. 

Line 150 displays the response on the terminal. 

When running this sample program, the oscilloscope will automati- 
cally be set to the remote state when IBWRT is executed, and will 
remain in that state. Pressing the LOCAL button on the front pan- 
el will return the oscilloscope to local mode if the GPIB handler 
was modified to inhibit Local LOckout (LLO). 

Here is a slightly modified version of the sample program which 
checks if any error occurred during GPIB operation: 
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Some Additional 
Driver Calls 



1-99 <DECL.BAS> 

100 DEV$=”DEV4" 

110 CALL IBFIND(DEV$,SCOPE%) 

120 CMD$=”TDIV?” 

130 CALL IBWRT(SCOPE%,CMD$) 

140 IF ISTA% < 0 THEN GOTO 200 

150 CALL IBRD(SCOPE%,RD$) 

160 IF ISTA% < 0 THEN GOTO 250 

170 PRINT RD$ 

180 IBLOC (SCOPE%) 

190 END 

200 PRINT “WRITE ERROR = ”;IBERR% 

210 END 

250 PRINT “READ ERROR = ”;IBERR% 

260 END 

The GPIB status word ISTA%, the GPIB error variable IBERR% 
and the count variable IBCNT% are defined by the GPIB handler 
and are updated with every GPIB function call. Refer to the Na- 
tional Instruments user’s manual for details. The sample program 
above would report if the GPIB address of the instrument was set 
to a value other then 4. Line 180 resets the instrument to local with 
a call to the GPIB routine IBLOC. 

Example 2 in Appendix A provides a more useful program which 
enables interactive setting and inspection of the front-panel con- 
trols as well as archiving and recalling of waveforms. Note that this 
program is written with just 7 different GPIB calls. 



IBLOC is used to execute the IEEE 488.1 standard message Go 
To Local (GTL), i.e. it returns the instrument to the local state. 
The programming example above shows its use. 

IBCLR executes the IEEE 488.1 standard message Selected De- 
vice Clear (SDC). 

IBRDF and IBWRTF allow data to be read from GPIB to a file 
and data to be written from a file to GPIB respectively. Transfer- 
ring data directly to or from a storage device does not limit the size 
of the data block, but it may be slower than transferring to the 
computer memory. Example 2 in Appendix A shows the use of 
these calls. 

IBRDI and IBWRTI allow data to be read from GPIB to an inte- 
ger array and data to be written from an integer array to GPIB. 
Since the integer array allows storage of up to 64 kilobytes (in BA- 
SIC), IBRDI and IBWRTI should be used for the transfer of large 
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data blocks to the computer memory, rather than IBRD or IBWRT 
which are limited to 256 bytes by the BASIC string length. Note 
that IBRDI and IBWRTI only exist for BASIC, since the function 
calls IBRD and IBWRT for more modem programming languages, 
such as C, are much less limited in the data block size. 

IBTMO can be used to change the time-out value during program 
execution. The default value of the GPIB driver is 10 seconds, e.g. 
if the instrument does not respond to a IBRD call, IBRD will return 
with an error after the specified time. 

IBTRG executes the IEEE 488.1 standard message Group Ex- 
ecute Trigger (GET), which causes the oscilloscope to arm the 
trigger system. 

National Instruments supply a number of additional function calls. 
In particular, it is possible to use the so-called board level calls 
which allow a very detailed control of the GPIB. The use of such 
calls is shown in Example 3 of Appendix A. 



PROGRAMMING 

SERVICE REQUESTS When an oscilloscope is used in a remote application, events often 

occur asynchronously, i.e. at times that are unpredictable for the 
host computer. The most common case is waiting for a trigger after 
the instrument has been armed. The controller must wait until the 
acquisition is finished before it can read the acquired waveform. 
The simplest way of checking if a certain event has occurred is by 
continuously or periodically reading the status bit associated with it 
until the required transition is detected. Continuous status bit poll- 
ing is described in more detail in the sub-section “Instrument 
Polls” . For a complete explanation of the status bytes refer to Sec- 
tion 7. 

A potentially more efficient way of detecting events occurring in 
the instrument is the use of the Service Request (SRQ) . This GPIB 
interrupt line can be used to interrupt program execution in the 
controller. Therefore, the controller can execute other programs 
while waiting for the instrument. Unfortunately, not all interface 
manufacturers support the programming of interrupt service rou- 
tines. In particular, National Instruments only supports the SRQ 
bit within the ISTA% status word. This requires the user to contin- 
uously or periodically check this word, either explicitly or with the 
function call IBWAIT. In the absence of real interrupt service rou- 
tines the use of SRQ may not be very advantageous. 

In the default state, after power-on, the Service ReQuest is dis- 
abled. The SRQ is enabled by setting the Service Request Enable 
register with the command “*SRE” and specifying which event 
should generate an SRQ. The oscilloscope will interrupt the con- 
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troller as soon as the selected event (s) occur by asserting the SRQ 
interface line. If several devices are connected to the GPIB, the 
controller may have to identify which instrument caused the inter- 
rupt by serial polling the various devices. 

Note : The SRQ bit is latched until the controller reads the STatus 
Byte Register (STB). The action of reading the STB with the com - 
mand “*STB?” clears the register contents except the MAV bit 
( bit 4) until a new event occurs . Service requesting may be dis- 
abled by clearing the SRE register (“*SRE 0”). 

Example 1 To assert SRQ in response to the events “new signal acquired” 

or “return-to-local” (pressing the front-panel button LO- 
CAL). 

These events are tracked by the INR register which is reflected in 
the SRE register as the INB summary bit in position 0. Since the bit 
position 0 has the value 1, the command “*SRE 1” enables the 
generation of SRQ whenever the INB summary bit is set. 

In addition, the events of the INR register which may be summa- 
rized in the INB bit must be specified. The event “new signal 
acquired” corresponds to INE bit 0 (value 1) while the event “re- 
turn-to-local” is assigned to INE bit 2 (value 4), The total sum is 
1+4=5. Thus the command “INE 5” is needed. 

CMD$=”INE 5;*SRE 1” 

CALL IBWRT(SCOPE%,CMD$) 

Example 2 To assert SRQ when soft key 10 is pressed. 

The event “soft key 10 pressed” is tracked by the URR register. 
Since the URR register is not directly reflected in STB but only in 
the ESR register (URR, bit position 6), the ESE enable register 
must be set first with the command “*ESE 64" to allow the URQ 
setting to be reported in STB. An SRQ request will now be gener- 
ated provided that the ESB summary bit (bit position 5) in the SRE 
enable register is set (“*SRE 32”). 

CMD$=” *ESE 64;*SRE 32” 

CALL IBWRT(SCOPE%,CMD$) 
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INSTRUMENT POLLS 



Continuous Poll 



State transitions occurring within the instrument can be remotely 
monitored by polling selected internal status registers. This sub- 
section discusses a number of polling methods which may be used 
to detect the occurrence of a given event. 

1 . Continuous poll 

2. Serial poll 

3. Parallel poll 

4. ‘1ST poll 

To emphasize the differences between these methods, the same 
example will be presented in each case, i.e. determining if a new 
acquisition has taken place. By far the simplest poll is the continu- 
ous poll. The other methods only make sense if interrupt service 
routines (servicing the SRQ line) are supported or if multiple de- 
vices on GPIB must be monitored simultaneously. 

In continuous polling a status register is continuously monitored 
until a transition is observed. This is the most straightforward 
method for detecting state changes but may be impracticable in 
some situations, especially in multiple device configurations. 

In the following example, the event “new signal acquired” is ob- 
served by continuously polling the INternal state change Register 
(INR) until the corresponding bit (in this case bit 0, i.e. value 1) is 
non-zero to indicate that a new waveform has been acquired. 
Reading INR clears it at the same time so that there is no need for 
an additional clearing action after a non-zero value has been de- 
tected. The command “CHDR OFF” instructs the instrument to 
omit any command headers when responding to a query. This sim- 
plifies the decoding of the response. The instrument would 
therefore send “1” rather than “INR 1”. 

CMD$=”CHDR OFF” 

CALL IBWRT(SCOPE%,CMD$) 

MASK% = 1 ’New Signal Bit has value 1 

LOOP% = 1 
WHILE LOOP% 

CMD$=”INR?” 

CALL IBWRT(SCOPE%,CMD$) 

CALL IBRD(SCOPE%,RD$) 

NEWSIG% = VAL(RD$) AND MASK% 

IF NEWSIG% = MASK% THEN LOOP% = 0 

WEND 
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Serial Poll 



Serial polling takes place once the SRQ interrupt line has been 
asserted. The controller examines which instrument has generated 
the interrupt by inspecting the SRQ bit in the STB register of each 
instrument. Because service request is based on an interrupt mech- 
anism, serial polling offers a reasonable compromise in terms of 
servicing speed in multiple device configurations. 

In the following example, the command “INE 1” enables the 
event “new signal acquired” to be reported in the INR to the INB 
bit of the status byte STB. The command “*SRE 1” enables the 
INB of the status byte to generate an SRQ whenever it is set. The 
function call IBWAIT instructs the computer to wait until one of 
three conditions occur: &H8000 in the mask (MASK%) corre- 
sponds to a GPIB error, &H4000 to a time-out error and &H0800 
to the detection of RQS (ReQuest for Service generated by the 
SRQ bit). 

Whenever IBWAIT detects RQS it automatically performs a serial 
poll to find out which instrument generated the interrupt. It will 
only exit if there was a time-out or if the instrument “SCOPE%” 
generated SRQ. The additional function call IBRSP fetches the 
value of the status byte which may be further interpreted. For this 
example to function properly the value of ’Disable Auto Serial 
Polling’ must be set ’off’ in the GPIB handler (use IBCONF.EXE 
to check). 

CMD$=” *CLS; INE 1; *SRE 1” 

CALL IBWRT(SCOPE%,CMD$) 

MASK% = &HC800 

CALL IBWAIT(SCOPE%,MASK%) 

IF (IBSTA% AND &HC000) <> 0 THEN PRINT “GPIB or 
Time-out Error” : STOP 
CALL IBRSP(SCOPE%,SPR%) 

PRINT “Status Byte = ”, SPR% 

Note: After the serial poll is completed , the RQS bit in the STB 
status register is cleared. Note that the other STB register bits 
remain set until they are cleared by means of a U *CLS” command 
or the instrument is reset . If these bits are not cleared, they cannot 
generate another interrupt . 

Serial polling is only an advantage if there are several instruments 
that may need attention. Board-level function calls can deal simul- 
taneously with several instruments attached to the same interface 
board. Refer to the National Instruments user’s manual. 
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Parallel Poll Parallel polling is only an advantage if there are several instru- 

ments that may need attention. 

In parallel polling, the controller simultaneously reads the Individ- 
ual STatus bit (1ST) of all the instruments to determine which one 
needs service. Since parallel polling allows up to eight different 
instruments to be polled at the same time, parallel polling is the 
fastest way to identify state changes of instruments supporting this 
capability. 

When a parallel poll is initiated, each instrument returns a status 
bit via one of the DIO data lines. Devices may respond either indi- 
vidually using a separate DIO line or collectively on a single data 
line. Data line assignments are made by the controller via a Paral- 
lel Poll Configure (PPC) sequence. 

In the following example, the command “INE 1” enables the 
event "new signal acquired” in the INR to be reported to the INB 
bit of the status byte STB. The PaRallel poll Enable register (PRE) 
determines which events will be summarized in the 1ST status bit. 
The command “*PRE 1” enables the INB bit to set the 1ST bit 
whenever it is set. Once parallel polling has been established, the 
parallel poll status is examined until a change on data bus line 
DI02 takes place. 

Stage 1: Enable the INE and PRE registers, configure the con- 
troller for parallel poll and instruct the oscilloscope to respond 
on data line 2 (DI02) 

CMD1$=“?_@$” 

CALL IBCMD(BRD0%,CMD1$) 

CMD$=”INE 1;*PRE 1” 

CALL IBWRT(BRDO%,CMD$) 
CMD4$=CHR$(&H5)+CHR$(&H69)+”?” 

CALL IBCMD(BRD0%,CMD4$) 
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Stage 2: Parallel poll the instrument until DI02 is set 

LOOP% = 1 
WHILE LOOP% 

CALL IBRPP(BRDO%,PPR%) 

IF (PPR% AND &H2) = 2 THEN LOOP% = 0 

WEND 

Stage 3: Disable parallel polling (hex 15) and clear the parallel 
poll register 

CMD5$=CHR$(&H15) 

CALL IBCMD(BRD0%,CMD5$) 

CALL IBCMD(BRD0%,CMD1$) 

CMD$=” *PRE 0” 

CALL IBWRT(BRD0%,CMD$) 

Note 1: In the example above , board-level GPIB function calls 
are used . It is assumed that the controller (board) and oscillo- 
scope (device) are respectively located at addresses 0 and 4. The 
listener and talker addresses for the controller and oscilloscope 
are: 

Logic device Listener address Talker address 
controller 32 (ASCII<space>) 64 (ASCII @) 

oscilloscope 32+4=36 (ASCII $) 64+4=68 (ASCII D) 

Note 2: The characters “?” and appearing in the command 
strings stand for unlisten and untalk respectively. They are used to 
set the devices to a “known” state. 

Note 3: To shorten the size of the program examples, device talk- 
ing and listening initialization instructions have been grouped into 
character chains. They are: 

CMD1S = “?_@$" ’Unlisten, Untalk, PC talker, DSO listener 

Note 4: The remote message code for executing a parallel response 
in binary form is 01101PPP where PPP specifies the data line. 
Since data line 2 is selected, the identification code is 001 which 
results in the code 01 101001 (binary) or &H69 (hex). See Table 
38 of the IEEE 488-1978 Standard for further details . 

♦1ST Poll The state of the Individual STatus bit (1ST) returned in parallel 

polling can also be read by sending the “ *IST?" query. To enable 
this poll mode, the oscilloscope must be initialized as for parallel 
polling by writing into the PRE register. Since *IST polling emu- 
lates parallel polling, this method is applicable in all instances 
where parallel polling is not supported by the controller. 
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DRIVING A HARD-COPY 
DEVICE 



Plotting/Printing without 
a GPIB Controller 



In the following example, the command “INE 1” enables the 
event “new signal acquired” in the INR to be reported to the INB 
bit of the status byte STB. The command “*PRE 1” enables the 
INB bit to set the 1ST bit whenever it is set. The command “CHDR 
OFF” suppresses the command header in the response of the in- 
strument, simplifying the interpretation. The status of the 1ST bit is 
then continuously monitored until it is set by the instrument. 

CMD$=”CHDR OFF; INE 1; *PRE 1” 

CALL IBWRT(SCOPE%,CMD$) 

LOOP% = 1 
WHILE LOOP% 

CMD$=” *IST?” 

CALL IB WRT (SCOPE%,CMD$) 

CALL IBRD(SCOPE%,RD$) 

IF VAL(RD$) = 1 THEN LOOP% = 0 

WEND 



The oscilloscope can be interfaced to a wide range of plotters and 
printers and be instructed to directly plot or print the screen con- 
tents onto these devices. The devices supported by the unit are 
listed with the command “HARDCOPY_SETUP” in Section 5. 

When the hard-copy device is connected to the GPIB two differ- 
ent configurations should be considered depending on whether or 
not a GPIB controller is available. 



When only the oscilloscope and the hard-copy device are con- 
nected to the GPIB, the oscilloscope must be configured as 
talker-only and the hard-copy device as listener-only to ensure 
proper data transfer. The oscilloscope can be configured as a 
talker-only by using the thumbwheel switch at the rear of the in- 
strument to select an address larger than 30. The hard-copy 
device manufacturer usually specifies an address which forces the 
instrument into the listening mode. 

• Select the oscilloscope’s address to be larger than 30. 

• Switch on the oscilloscope. 

• Configure the “Hardcopy” sub menu in the “Auxiliary Set- 
ups” menu specifying “GPIB” as hard copy port. 

• Put the hard-copy device in listener-only mode. 

• Press the screen dump button on the front panel of the in- 
strument. 
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Plotting/Printing with 
a GPIB Controller 



1. Data read by controller 
and sent to printer/plotter 



2. Oscilloscope sends data to 
controller and printer/plotter 



If a controller is connected to the GPIB, data transfers must be 
supervised by the controller. The oscilloscope must be set to an 
address between 0 and 30 which differs from the controller’s and 
the hard-copy device’s address. Different schemes can be used to 
transfer the screen contents: 

1. The controller reads the data into internal memory and then 
sends them to the printer/plotter. This alternative can be 
done with simple high-level GPIB function calls. 

2. The oscilloscope sends data to both the controller and the 
printer/plotter. 

3. The controller goes into a standby state. The oscilloscope 
becomes a talker and sends data directly to the printer/plot- 
ter. 



The controller stores the full set of printer/plotter instructions and 
sends them afterwards to the graphics device. This method is the 
most straightforward way of transferring screen contents but it re- 
quires a large amount of buffer storage (110K for 4 traces). 

CMD$ = “SCDP” 

CALL IBWRT(SCOPE%,CMD$) 

FILE$=” PLOT. DAT” 

CALL IBRDF(SCOPE%, FILES) 

CALL IBWRTF(PLOTTER%, FILES) 



The oscilloscope puts the printer/plotter instructions on to the bus. 
The data is directly plotted out and saved in scratch memory in the 
controller. The contents of the scratch file can be deleted later on. 

Stage 1: Controller talker, oscilloscope listener. Issue the 
screen dump command 

CMD1$=”?_@$”: CALL IBCMD(BRD0%,CMD1$) 
CMD$=”SCDP”: CALL IBWRT(BRD0%,CMD$) 

Stage 2: Oscilloscope talker, controller and plotter listeners. 
Plot data while storing data in scratch file SCRATCH.DAT 

CMD2$=”?_ D%": CALL IBCMD(BRD0%,CMD2$) 

FILE$=” SCRATCH. DAT”: CALL IBRDF(BRD0%, FILES) 
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3. Oscilloscope talks directly 
to plotter/printer 



The controller goes into stand-by and resumes GPIB operations 
once the data have been plotted, that is when an EOI is detected. 

Stage 1: Controller talker, oscilloscope listener. Issue the 
screen dump command 

CMD1$=”?_@$”: CALL IBCMD(BRD0%,CMD1$) 
CMD$=”SCDP”; CALL IBWRT(BRDO%,CMD$) 



Stage 2: Oscilloscope talker, plotter listener. Put controller in 
stand-by 

CMD2$=”?_D%”: CALL IBCMD(BRD0%,CMD2$) 

V%=1: CALL IBGTS (BRD0%, V%) 

Note 1: In schemes 2 and 3, board-level GPIB function calls are 
used . It is assumed that the controller (board), the oscilloscope 
and the plotter are respectively located at addresses 0, 4 and 5. 
The listener and talker addresses for the controller , oscilloscope 
and plotter are: 



Logic device Listener address 



Talker address 



controller 32 (ASCII<space>) 

oscilloscope 32+4=36 (ASCII $) 
hard-copy dev. 32+5=37 (ASCII %) 



64 (ASCII @) 
64+4=68 (ASCII D) 
64+5=69 (ASCII E) 



Note 2: The characters “?” and appearing in the command 
strings stand for unlisten and untalk respectively . They are used to 
set the devices to a “known” state. 



Note 3: To shorten the size of the program examples , device talk- 
ing and listening initialization instructions have been grouped into 
character chains. They are: 

CMD1S = “?_@$” ’Unlisten, Untalk, PC talker, DSO listener 
CMD2$ = “? D” ’Unlisten, Untalk, PC listener, DSO talker 
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4 



RS-232-C OPERATION 



INTRODUCTION 



Notation 



Example 



RS-232-C 

PIN ASSIGNMENTS 



LeCroy oscilloscopes may be remotely controlled using a host, ei- 
ther a terminal or a computer, via the RS-232-C port. For this 
purpose the oscilloscope must be set at an address higher than 30 
using the thumbwheel switch at the rear of the instrument. 

All the commands described in Section 5 are supported but wave- 
form transfer is only possible in HEX mode. The default value 
for COMM_FORMAT is set appropriately. The syntax of the re- 
sponse to WF? is identical to the GPIB case. 

In this section some special RS-232-C commands are defined ei- 
ther for configuring the oscilloscope, or simulating GPIB 488.1 
messages such as setting the oscilloscope into remote or local 
modes. 

Throughout this section, characters which cannot be printed in 
ASCII will be represented by their mnemonics. 

<LF> is the ASCII line feed character whose decimal value is 
10 

<BS> is the ASCII backspace character whose decimal value 
is 8 

CTRLJU means that the control key and the U key are pressed 
simultaneously. 



The remote RS-232-C pin assignments (indicated on the rear 
panel) are as follows: 



Pin # 

2 T X D 

3 R X D 

4 RTS 



5 CTS 



20 DTR 



Description 

Transmitted data (from the oscilloscope). 
Received data (to the oscilloscope). 

Request to send (from the oscilloscope). 

If the software Xon/Xoff handshake is se- 
lected it is always TRUE. 

Otherwise (hardware handshake) it is TRUE 
when the oscilloscope is able to receive char- 
acters and FALSE when the oscilloscope is 
unable to receive characters. 

Clear to send (to the oscilloscope). 

When true, the oscilloscope can transmit, 
when false, transmission stops. It is used for 
the oscilloscope output hardware handshake. 

Data terminal ready (from oscilloscope). 
Always TRUE. 
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^ RS-232-C Operation 



CONFIGURATION 



Echo of Received Characters 
by the Oscilloscope 



Handshake Control 



1 GND Protective Ground. 

7 SIG GND Signal Ground. 



The RS-232-C port is configured in full duplex. This means that 
the two sides (i.e. the controller and the oscilloscope) can both 
send and receive messages at the same time. However, when the 
oscilloscope receives a new command, it stops outputting. 

Transmission of long messages to the oscilloscope should be done 
while the oscilloscope is in a triggered mode with no acquisition 
in progress. This is especially important when sending waveforms 
or front-panel setups into the oscilloscope. 

The behavior of the RS-232-C port may be set according to the 
user’s needs. For this purpose, in addition to the basic setup on 
the front-panel menu there are “immediate commands” as well 
as a special command “COMM_RS232” . Immediate commands 
consist of the ASCII ESCape character <ESC> (whose decimal 
value is 27), followed by another character. Such commands are 
interpreted as soon as the second character has been received. 

Note: The RS-232-C baud rate , parity , character length and 
number of stop bits are among the parameters that are saved or 
recalled by the front-panel “SAVE” or “RECALL” button, or by 
the remote commands “*SAV”, “*RCL” or “PANEL_SETUP ”. 
When recalling, care must be taken to ensure that these parame- 
ters are set at the same value as the actual ones. Otherwise, the 
host may no longer be able to communicate with the oscilloscope 
and a manual reconfiguration would be necessary. 



The serial port may echo the received characters. Echo is useful if 
the oscilloscope is attached to a terminal. Echoing can be turned 
on or off by sending the two character sequence <ESC>] or 
<ESC>[ respectively. Echoing is on by default. 

Note: The host must not echo characters received from the oscillo- 
scope. 

When the oscilloscope input buffer becomes almost full, the in- 
strument sends a handshake signal to the host telling it to stop 
transmitting. When this buffer has enough room to receive more 
characters another handshake signal will be sent. The handshake 
signals are either the CTRL-S (or <XOFF>) and CTRL-Q 
(<XON>) characters or a signal level on the RTS line (pin 4). This 
is selected by sending the two-character sequence <ESC>) for 
XON/XOFF handshake - this is the default - or <ESC>( for RTS 
handshake. 
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RS-232-C Operation 4 



Editing Features 



Message Terminators 



Examples 



The flow of characters coming from the oscilloscope may be con- 
trolled either by a signal level on the CTS line (pin 5) or by the 
<XON>/<XOFF> pair of characters. 

When the oscilloscope is directly connected to a terminal, the fol- 
lowing features will facilitate the correction of typing errors: 

<BS> or <DELETE> Delete the last character. 

CTRL_U Delete the last line. 

“Message terminators” are markers that indicate to the receiver 
that a message has been completed. 

On input to the oscilloscope, the Program Message Terminator 
is one character which can be selected by the user. A good choice 
would be a character that is never used for anything else. The 
character is chosen using the command COMM_RS232 and the 
keyword EL The default Program Message Terminator is the 
ASCII character <CR>, whose decimal value is 13. 

The oscilloscope appends a Response Message Terminator to the 
end of each of its responses. It is a string, like a computer prompt, 
chosen by the user. This string must not be empty. The default 
Response Message Terminator is “\n\r” which means 
<LFxCR>. 

(1) COMM_RS232 El, 3 

This command informs the oscilloscope that each message it 
receives will be terminated with the ASCII character <ETX> 
which corresponds to 3 in decimal. 

(2) COMM_RS232 EO,”\r\nEND\r\n” 

This command indicates to the oscilloscope that it must ap- 
pend the string “\r\nEND\r\n” to each response. 

After these settings, a host command will look like: 
TDIV?<ETX> 

The oscilloscope responds: 

TDIV 1. S 
END 

Note: Having sent a COMM_RS232 command, the host must wait 
for the oscilloscope to change its behavior before sending a com - 
mand in the new mode. A safe way to do this is to include a query 
on the line which contains the COMMJRS232 command and wait 
until the response is received . For example, 

COMMJIS232 El, 3; *STB? 
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^ RS-232-C Operation 



SRQ Message 



Example 



Long Line Splitting 



Example 



Remarks 



Each time the Master Summary Status (MSS) bit of the STatus 
Byte (STB) is set, the SRQ message (a string of characters) is sent 
to the host to indicate that the oscilloscope requests service. The 
RS-232-C SRQ message has the same meaning as the GPIB SRQ 
message. If the string is empty, no message will be sent. This is the 
default setting. Note that no response message terminator is added 
at the end of the SRQ message. 

COMM_RS232 SRQ,”\r\n\nSRQ\r\n\a” 

When the MSS bit is set, the oscilloscope will send 
a <CR> followed by 2 <LF>s 
SRQ 

a <CR> followed by 1 <LF> 
and the buzer will sound. 

Line splitting is a feature provided for hosts that cannot accept 
lines with more than a certain number of characters. The oscillo- 
scope may be configured to split responses into many lines. This 
feature is very useful for waveform or front-panel setup transfers 
although it is applicable to all response messages. Two parameters 
control this feature: 

Line Separator: Off messages will not be 

split into lines 

<CR>,<LF> or <CRxLF> possible line termi- 
nators. 

Line length: the maximum number of characters in a line. 

COMM_RS232 LS,LF,LL,40 

The line separator is the ASCII character <LF>, the line is a maxi- 
mum of 40 characters long (excluding the line separator). 

If the oscilloscope receives the command PNSU?, it may answer: 

PNSU *9000001496 

AAAA5 5 5 500065 5AA4030005 8001 9000000000001 
OOOOOOOOOOOOOOOOOOOOOOOOOOOCIBOIOO 58 OOOO 
0000000000000000000000000000000000000000 



Long commands sent to the oscilloscope may not be split into 
lines. If a command sent to the oscilloscope is the response to a 
previous query, the line split characters (<LF> and/or <CR>) must 
be removed. 
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RS-232-C Operation 4 



COMMANDS SIMULATING 
GPIB COMMANDS 

<ESC>C or <ESC>c 
Device clear command. 



<ESC>R or <ESC>r 
Set to remote command 
(REN) 



<ESC>L or <ESC>1 
Set to local command 



<ESC>F or <ESC>f 

Set local lockout command 



<ESC>T or <ESC>t 
Trigger command (GET) 



This also applies to line split characters inside strings sent to the 
oscilloscope. 

However, hex-ASCII data sent to the oscilloscope may contain 
line split characters. If you wish to use line splitting, ensure that 
neither the input message terminator characters nor the line split 
characters occur in the data. 



This command clears the input and output buffers. It has the same 
meaning as the GPIB DCL or SDC interface messages. 



This command puts the oscilloscope into the remote mode. Its 
function is the same as GPIB asserting the REN line and setting the 
oscilloscope to listener. 



This command puts the oscilloscope into local mode. It clears local 
lockout. It has the same function as GPIB setting the REN line to 
false. 



This command disables the front-panel “LOCAL” button either 
immediately if the oscilloscope is already in the remote mode or 
later when the oscilloscope is next set to remote control. This dis- 
abling of the front-panel “LOCAL” button is called “Local 
Lockout” and can only be cancelled with the <ESC>L command. 
<ESC>F has the same meaning as the GPIB LLO interface mes- 
sage. 



This command rearms the oscilloscope while it is in “SINGLE” or 
in “SEQUENCE” mode (valid only while the oscilloscope is in the 
remote mode). It has the same meaning as the “ *TRG” com- 
mand, and also the same meaning as the GPIB GET interface 
message. 
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5 

ORGANIZATION 



COMMAND SUMMARY 
Acquisition 



Communication 



SYSTEM COMMANDS 



This section of the manual lists all commands and queries recog- 
nized by the oscilloscope. For easy reference the listings are 
arranged in alphabetical order. Each command starts on a new 
page and the name (header) of the command is given in both the 
long and short forms. Below each name (header) it is indicated 
whether it denotes a command only, a command as well as a 
query, or a query only. For those headers that may be used to 
command an action, for example to modify a setup parameter, or 
to obtain some information such as the current value of a setup 
parameter, the query form is derived by appending a question 
mark (?) immediately to the header without intervening spaces. 

The description of each command starts with a short explanation 
of the function performed by it, followed by a presentation of the 
formal syntax. In the formal syntax the header appears in mixed 
mode characters with the characters used to construct the short 
form shown in upper case. 

Where applicable, the syntax of the query form is given along with 
the format of the response the oscilloscope will produce. 

For most commands the description terminates with a short exam- 
ple illustrating a typical use of the command. The GPIB examples 
assume that the controller is equipped with a National Instruments 
interface board, and they show calls to the National Instruments 
interface subroutines in BASIC. The device name of the oscillo- 
scope has been defined as “SCOPE%”. 

The following is an overview of the commands grouped according 
to their functionality. 

To control the acquisition of waveforms: 
ARM_ACQUISITION, AUTO_SETUP, BANDWIDTH_LIMIT, 
INTERLEAVED, SAMPLE_CLOCK, SEGMENTS, STOP, 
*TRG, WAIT. 

To select vertical input parameters to capture waveforms: 
ATTENUATION, COUPLING, OFFSET, VOLT_DIV. 

To select time-base parameters to capture waveforms: 
TIMEJDIV, TRIGJDELAY. 

To select trigger conditions to capture waveforms: 
TRIG_COUPLING, TRIG_LEVEL, TRIG_MODE, 
TRIGJPATTERN, TRIG_SELECT, TRIG_SLOPE. 

To set communication characteristics: 

COMMJORMAT, COMM_HEADER, COMM_HELP, 
COMMJDRDER, COMM_RS232, PERSIST_SETUP. 
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^ System Commands 



Cursor 



Display 



Function 



Hard Copy 



Save/Recall Setup 



Status 



Waveform Transfer 



Miscellaneous 



To perform measurements: 

CURSOR_MEASURE, CURSOR_SET, CURSOR_VALUE?, 
PARAMETER_VALUE?, PER_CURSOR_SET, 
PER_CURSOR_VALUE, XY_CURSOR_ORIGIN, 
XY_CURSOR_SET, XY_CURSOR_VALUE7. 



To display waveforms: 

DISPLAY, DUAL_ZOOM, GRID, HOR_MAGNIFY, 
HOR_POSITION, INTENSITY, MULTI_ZOOM, PERSIST, 
SELECT, TRACE, VERT_MAGNIFY, VERT_POSITION, 
XY_ASSIGN, XY_DISPLAY, ZOOM. 

To display messages to a local user: 

CALL_HOST, KEY, MESSAGE. 



To perform mathematical operations on waveforms: 
DEFINE, FUNCTION_RESET, FUNCTION_STATE. 



To plot or print the contents of the display screen: 

HARDCOPY_SETUP, HARDCOPY_TRANSMIT, 
SCREEN_DUMP. 



To preserve and restore front-panel settings: 

PANEL_SETUP, *RCL, RECALL_PANEL, *RST, *SAV, 
STORE_PANEL. 

To obtain status information and set up service requests: 

ALL_STATUS?, *CLS, CMR?, DDR?, *ESE, *ESR?, EXR?, 
INE, INR?, ’1ST?, *OPC, *PRE, *SRE, *STB?, URR?, *WAI. 



To preserve and restore waveforms: 

INSPECT?, RECALL. STORE, STORE_SETUP, 
STOREJTEMPLATE, TEMPLATE?, WAVEFORM, 
WAVEFORM_SETUP, WAVEFORM_TEXT. 

To control the calibration and test the instrument: 
AUTO_CALIBRATE, *CAL?, *TST?. 

To control the built-in buzzer: 

BUZZER. 

To control the real-time clock: 

DATE. 
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System Commands 



To delete a file from the memory card: 

DELETE_FILE 

To obtain a directory listing of the memory card: 
DIRECTORY_LIST? 

To format the memory card: 

FORMAT_CARD 
To identify the instrument: 

*IDN7, *OPT?. 

COMMAND EXECUTION Before attempting to execute a command or query, the oscillo- 
scope scans it to verify its correctness and that sufficient 
information is given to perform the requested action. To protect 
the local user from changes in the oscilloscope’s behavior which 
are beyond his control, the remote user must set the oscilloscope 
to the remote state to execute commands that affect the operation 
of the instrument as an oscilloscope. If such a command is re- 
ceived while the oscilloscope is operating in the local state, an 
execution permission error is generated and the execution of the 
command is denied. Vice versa, the local user cannnot interfere 
with the remote user because all front-panel controls are disabled 
while the oscilloscope is in the remote state. 

Since interrogating the oscilloscope does not change its internal 
state, it may be queried at any time, independently of local or 
remote operation. There are only two exceptions to this rule: the 
queries *CAL? and *TST? both recalibrate the oscilloscope and 
are therefore executed in the remote state only. 

Commands that only affect the remote behavior are executed in- 
dependently of whether the oscilloscope is in the local or remote 
state. In this category are all commands that modify communica- 
tion parameters (COMM_FORMAT, COMM_HEADER, 
COMM_HELP, COMMJ3RDER, COMM_RS232), all com- 
mands affecting status information (*CLS, *ESE, INE, *OPC, 
*PRE, *SRE, *WAI), and the commands used to display messages 
on the screen to the local user (CALL_HOST, KEY, MESSAGE) . 

In the description of each command, only exceptions to the rule 
that a command is executed only in the remote state and a query is 
executed in both the local and remote states are mentioned. 

COMMAND NOTATION The following notation is used in the description of the individual 

commands : 

< > Angular brackets enclose words that are used as placehold- 
ers. There are two types of placeholders: (1) the header 
path, (2) a data parameter of a command. 
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:= A colon followed by an equals sign separates a placeholder 
from the description of the type and range of values that may 
be used in a command instead of the placeholder. 

{ } Braces enclose a list of choices from which one must be se- 
lected. 

[ ] Square brackets enclose optional items. 

An ellipsis indicates that the items to the left and to the right 
of the ellipsis may be repeated zero or more times. 

As an example, consider the syntax notation for the command to 
set the vertical input sensitivity: 

<channel>:VOLT_DIV <v_gain> 

<channel> := {Cl, C2} 

< v g ain> := 5.0 mV to 2.5 V 

The first line shows the formal appearance of the command with 
<channel> denoting the placeholder for the header path, and 
<v _g a i n> denoting the placeholder for the data parameter specify- 
ing the desired vertical gain value. The second line indicates that 
either “Cl” or “C2” must be chosen for the header path, and the 
third line explains that the actual vertical gain can be set to any 
value between 5 mV and 2.5 V. 



System Commands 



STATUS 

DESCRIPTION 



QUERY SYNTAX 
Response format 

EXAMPLE (GPIB) 



RELATED COMMANDS 



ALLJSTATUS?, ALST? 

Query 



The ALL_STATUS? query reads and clears the contents of all 
status registers: STB, ESR, INR, DDR, CMR, EXR, and URR ex- 
cept the MAV bit (bit 6) of the STB register. For an interpretation 
of the contents of each register, refer to the appropriate status 
register. 

The ALL_STATUS? query is useful if a complete overview of the 
state of the instrument is required. 

ALl_STatus? 

ALl_STatus STB,<value>,ESR,<value>,INR,<value>, 
DDR,<value>, CMR<value>,EXR,<value>,URR,<value> 

<value> := 0 to 65535 

The following instruction reads the contents of all the status regis- 
ters. 

CMD$=” ALST?” : CALL IBWRT(SCOPE%,CMD$) 

CALL IBRD(SCOPE%,RSP$): PRINT RSP$ 

Response message 

ALST STB, 000000, ESR, 000052, INR, 000005, DDR, 000000, 
EXR, 000024, CMR, 000004, URR, 000000 

*CLS, CMR?, DDR?, *ESR?, EXR?, »STB?, URR? 
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System Commands 



ACQUISITION 

DESCRIPTION 

COMMAND SYNTAX 
EXAMPLE 

RELATED COMMANDS 



ARM_ACQUISmON, ARM 

Command 



The ARM_ACQUISITION command enables the signal acquisi- 
tion process by changing the acquisition state from “triggered” to 
“ready”. 

ARM_acquisition 

The following command enables signal acquisition. 

CMD$ = ’’ARM”: CALL IBWRT(SCOPE%,CMD$) 

STOP, *TRG, TRIG_MODE, WAIT 
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System Commands 



ACQUISITION 

DESCRIPTION 

COMMAND SYNTAX 

QUERY SYNTAX 
Response format 
EXAMPLE (GPIB) 



X 4-channel oscilloscopes only 



ATTENUATION, ATTN 

Command/Query 



The ATTENUATION command selects the vertical attenuation 
factor of the probe. Values of 1, 10, 100, 1000 or 10000 may be 
specified. 

The ATTENUATION? query returns the attenuation factor of the 
specified channel. 

<channel>:ATTeNuation <attenuation> 

<channel> := {Cl, C2, C3$, C4$} 

<attenuation>:= {1, 10, 100, 1000, 10000} 

<channel>: ATTeNuation? 

<channel>:ATTeNuation <attenuation> 

The following command sets the attenuation factor of channel 1 to 

100 . 

CMD$=”C1:ATTN 100”: CALL IBWRT(SCOPE%,CMD$) 
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^ System Commands 



MISCELLANEOUS 

DESCRIPTION 



COMMAND SYNTAX 

QUERY SYNTAX 
Response Format 
EXAMPLE (GPIB) 

RELATED COMMANDS 



AUTO CALIBRATE, ACAL 

Command/Query 



The AUTO_CALIBRATE command is used to enable or disable 
automatic calibration of the instrument. At power-up, auto-cali- 
bration is turned ON, i.e. all input channels are periodically 
calibrated for the current input amplifier and time-base settings. 

The automatic calibration may be disabled by issuing the com- 
mand ACAL OFF. Whenever it is convenient, a *CAL7 query 
may be issued to fully calibrate the oscilloscope. When the oscillo- 
scope is returned to local control, the periodic calibrations will be 
resumed. 

The response to the AUTO_CALIBRATE? query indicates 
whether auto-calibration is enabled. 

Auto_CALibrate <state> 

<state> := {ON, OFF} 

Auto_CALibrate? 

Auto_CALibrate <state> 

The following instruction disables auto-calibration. 
CMD$=”ACAL OFF”: CALL lBWRT(SCOPE%,CMD$) 

•CAL? 
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System Commands ^ 



ACQUISITION 

DESCRIPTION 



COMMAND SYNTAX 
EXAMPLE 



AUTO SETUP, ASET 

Command 



The AUTO_SETUP attempts to display the input signal(s) by ad- 
justing the vertical, time-base and trigger parameters. Auto-setup 
operates only on the channels whose traces are currently turned 
on. The only exception occurs when no traces are turned on, in 
which case AUTO_SETUP operates on all channels and turns on 
all of the traces. 

If signals are detected on several channels, the lowest numbered 
channel with a signal determines the selection of the time base and 
trigger source. 

If only one input channel is turned on, the time base will be ad- 
justed for that channel. 

Auto_SETup 

The following command instructs the oscilloscope to perform an 
auto-setup. 

CMD$ = ’’ASET”: CALL IBWRT(SCOPE%,CMD$) 
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System Commands 



ACQUISITION 

DESCRIPTION 

COMMAND SYNTAX 

QUERY SYNTAX 
Response Format 
EXAMPLE 



BANDWIDTH_LIMIT, BWL 

Command/Query 



The BANDWIDTH_LIMIT command enables or disables the 
bandwidth limiting low pass filter. 

The response to the BANDWIDTH_LIMIT? query indicates if the 
bandwidth filter is on or off. 

BandWidth_Limit <mode> 

<mode> := {ON, OFF} 

BandWidth_Limit? 

BandWidth_Limit <mode> 

The following command turns the bandwidth filter on. 

CMDS = "BWL ON”: CALL IBWRT(SCOPE%,CMD$) 
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System Commands £ 



MISCELLANEOUS 

DESCRIPTION 



COMMAND SYNTAX 
EXAMPLE (GPIB) 



BUZZER, BUZZ 

Command 



The BUZZER command controls the built-in piezo-electric buzz- 
er. This may be useful to attract the attention of a local operator in 
an interactive working application. The buzzer may either be acti- 
vated for short beeps (about 400 msec long in BEEP mode) or 
continuously for a certain time interval selected by the user by 
turning the buzzer ON or OFF. A beep request which immediately 
follows another beep request will be held off for approximately 
200 msec. 

Note: This command is always accepted (local and remote ). 
BUZZer := (BEEP, ON, OFF} 

Sending the following code will cause the oscilloscope to sound two 
short tones. 

CMD$ = “BUZZ BEEP; BUZZ BEEP”; 

CALL IB WRT (SCOPE%, CMDS) 
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^ System Commands 



MISCELLANEOUS 

DESCRIPTION 



QUERY SYNTAX 
Response Format 



EXAMPLE (GPIB) 



RELATED COMMANDS 
t 4-channel oscilloscopes only. 



*CAL? 

Query 



The *CAL? query performs a complete internal calibration. This 
calibration sequence is the same as that which occurs at power-up. 
At the end of the calibration, the response indicates how the cali- 
bration terminated. When the calibration is finished, the 
instrument returns to the state it was in prior to the query. 

Hardware failures are identified by a unique binary code in the 
returned <status> number (see Table 1 ). A “0" response indicates 
that no failures occurred. 

Note: This query is only accepted in remote mode. 

♦CAL? 

•CAL <diagnostics> 

<diagnostics> := 0 calibration successful 



BIT 


BIT VALUE 


DESCRIPTION 


0 


1 


CHI failure 


1 


2 


CH2 failure 


2 


4 


CH3 failure* 


3 


8 


CH4 failure* 


4 


16 


TDC failure 


5 


32 


Trigger circuit failure 



Failures 

Table 1 



The following instruction forces a self-calibration. 

CMD$=” *CAL?": CALL IBWRT(SCOPE%,CMD$) 
CALL IBRD(SCOPE%,RD$): PRINT RD$ 

Response message (if no failure) 

•CAL 0 

AUTO_CALIBRATE 

reserved in the 2-channel oscilloscopes 




System Commands j*) 



DISPLAY 

DESCRIPTION 



COMMAND SYNTAX 

QUERY SYNTAX 
Response format 

EXAMPLE (GPIB) 
RELATED COMMANDS 



CALL_HOST, CHST 

Command/Query 



The CALL_HOST command allows the user to manually generate 
a service request (SRQ). Once the CALL_HOST command has 
been received, the message “Call Host” will be displayed next to 
the lowest button (10) in the menu field (II). Pressing this button 
while in the root menu causes the User Request status Register 
(URR) and the URQ bit of the Event Status Register to be set. This 
can generate a SRQ in local mode provided that the service re- 
quest mechanism has been enabled. 

The response to the CALL_HOST? query indicates whether call 
host is enabled (on) or disabled (off). 

Note: This command can be executed in both local and remote 
modes. 

Call_HoST <state> 

<state> := {ON, OFF} 

Call_HoST? 

Call_HoST <state> 

After executing the following code an SRQ request will be gener- 
ated whenever button 10 is pressed. It is assumed that SRQ 
servicing has already been enabled. 

CMD$=”CHST ON”: CALL IBWRT(SCOPE%,CMD$) 

URR? 
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^ System Commands 



STATUS *CLS 

Command 



DESCRIPTION The *CLS command clears all the status data registers. 

Note: This command can be executed in both local and remote 

modes. 



COMMAND SYNTAX 
EXAMPLE (GPIB) 

RELATED COMMANDS 



•CLS 

The following command causes all the status data registers to be 
cleared. 

CMD$ = “*CLS”: CALL IBWRT(SCOPE%,CMD$) 
ALL_STATUS?, CMR?, DDR?, *ESR?, EXR?, *STB?, URR? 
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System Commands 



STATUS 

DESCRIPTION 

QUERY SYNTAX 
Response format 

EXAMPLE (GPIB) 
RELATED COMMANDS 



CMR? 

Query 



The CMR? query reads and clears the contents of the CoMmand 
error Register (CMR). The CMR register (Table 2) specifies the 
last syntax error type detected by the instrument. 

CMR? 

CMR <value> 

<value> := 1 to 13 

The following instruction reads the contents of the CMR register. 

CMD$=”CMR?” : CALL IBWRT(SCOPE%,CMD$) 

CALL IBRD(SCOPE%,RSP$): PRINT RSP$ 

Response message 

CMR 0 

ALL_STATUS?, *CLS 



Value 


Description 


1 


Unrecognized command/query header 


2 


Illegal header path 


3 


Illegal number 


4 


Illegal number suffix 


5 


Unrecognized keyword 


6 


String error 


7 


GET embedded in another message 


10 


Arbitrary data block expected 


11 


Non-digit character in byte count field of 
arbitrary data block 


12 


EOI detected during definite length data block 
transfer 


13 


Extra bytes detected during definite length data 
block transfer 



Command Error Status Register Structure (CMR) 
Table 2 
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^ System Commands 



COMMUNICATION 

DESCRIPTION 



COMMAND SYNTAX 



QUERY SYNTAX 
Response Format 

EXAMPLE (GPIB) 
EXPLANATION 



COMM FORMAT, CFMT 

Command/Query 



The COMM_FORMAT command selects the format which the 
oscilloscope will use to send waveform data. The available options 
allow (1) the block format, (2) the data type and (3) the encoding 
mode to be modified from the default settings. 

Note: This command can be executed in both local and remote 
modes . 

The COMM_FORMAT? query returns the currently selected 
waveform data format. 

Comm_ForMaT <block_format>,<data_type>,<encoding> 

<block_format> := {DEF9, INDO, OFF} 

<data_type> := {BYTE, WORD} 

<encoding> := {BIN, HEX} 

(GPIB uses both encoding forms, RS-232-C always uses HEX) 

Initial settings (i.e. after power on) are: 

DEF9, WORD, BIN for GPIB 
DEF9, WORD, HEX for RS-232-C 

Comm_ForMaT? 

Comm_ForMaT <block_format>,<data_type>,<encoding> 

The following code redefines the transmission format of waveform 
data. The data will be transmitted as a block of indefinite length. 
Data will be coded in binary and represented as 8-bit integers. 

CMD$=”CFMT INDO, BYTE, BIN” 

CALL IBWRT(SCOPE%,CMD$) 

BLOCK FORMAT 

DEF9: Uses the IEEE 488.2 definite length arbitrary block re- 

sponse data format. The digit 9 indicates that the byte 
count consists of 9 digits. The data block directly follows 
the byte count field. 

For example, a data block consisting of 3 data bytes 
would be sent as: 

WF DATl,#9000000003<DABxDABxDAB> 
where <DAB> represents an 8-bit binary data byte. 



50 




System Commands 



INDO: Uses the IEEE 488.2 indefinite length arbitrary block 

response data format. 

A <Nl/END> (new line with EOI) signifies that block 
transmission has ended. 

The same data bytes as above would be sent as: 

WF DATl,#0<DABxDABxDABxNL A END> 

OFF: Same as INDO. In addition, the data block type identi- 

fier and the leading #0 of the indefinite length block will 
be suppressed. The data presented above would be sent 
as: 

WF <DABxDABxDABxNL A END> 

Note: The format OFF does not conform to the IEEE 488.2 stan- 
dard and is only provided for special applications where the 
absolute minimum of data transfer may be important. 

DATA TYPE 

BYTE: Transmits the waveform data as 8-bit signed integers 

(1 byte). 

WORD: Transmits the waveform data as 16-bit signed integers 
(2 bytes). 

Note: The data type BYTE transmits only the high order bits of the 
internal 16-bit representation. The precision contained in the low 
order bits is lost. 

ENCODING 

BIN: Binary encoding (GPIB only) 

HEX: Hexadecimal encoding (bytes are converted to 2 hexa- 

decimal ASCII digits (0, ... 9, A, ... F)) 

RELATED COMMANDS WAVEFORM? 
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COMMUNICATION 

DESCRIPTION 



COMMAND SYNTAX 

QUERY SYNTAX 
Response Format 

EXAMPLE (GPIB) 



COMM_HEADER, CHDR 

Command/Query 



The COMM_HEADER command controls the way the oscillo- 
scope will format responses to queries. The instrument provides 
three response formats: (1) LONG format, i.e. responses start 
with the long form of the header word; (2) SHORT format, i.e. 
responses start with the short form of the header word; (3) OFF, 
i.e. headers are omitted from the response and suffix units in num- 
bers are suppressed. Until the user requests otherwise, the SHORT 
response format is used. 

This command does not affect the interpretation of messages sent 
to the oscilloscope. Headers may be sent in their long or short 
form regardless of the COMM_HEADER setting. 

Querying the vertical sensitivity of Channel 1 may result in one of 
the following responses: 



COMM_HEADER 


RESPONSE 


LONG 


CHANNELJ :VOLT_DIV 200E-3 V 


SHORT 


Cl :VDIV 200E-3 V 


OFF 


200E-3 



Note: This command can be executed in both local and remote 
modes. 

Comm_HeaDeR <mode> 

<mode> := {SHORT, LONG, OFF} 

Note: The default mode, i.e. the mode just after power on, is 
SHORT . 

Comm_HeaDeR? 

Comm_HeaDeR <mode> 

The following code sets the response header format to short. 
CMD$ = ”CHDR SHORT”; CALL IBWRT(SCOPE%,CMD$) 
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COMMUNICATION 



COMM HELP, CHLP 

Command/Query 



DESCRIPTION 



COMMAND SYNTAX 



QUERY SYNTAX 
Response Format 

EXAMPLE (GPIB) 



The COMM_HELP command enables the help diagnostics utility 
to assist remote program debugging. When turned on, this utility 
displays all message transactions occurring between the controller 
and the oscilloscope on a terminal, printer or similar recording 
device connected to the RS-232-C port. Errors detected by the 
instrument can be directly viewed. 

Note: This command can be executed in both local and remote 
modes. 

The COMM_HELP? query indicates if the diagnostics utility has 
been enabled. 

Comm_HeLP <target> 

<target> := {RS, OFF} 

The initial <target>, (i.e. after power on) is OFF. 

Comm_HeLP? 

Comm_HeLP <target> 

The following code turns on the remote control diagnostics utility. 
CMD$=”CHLP RS”; CALL IBWRT(SCOPE%,CMD$) 
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COMMUNICATION 

DESCRIPTION 



COMMAND SYNTAX 

QUERY SYNTAX 
Response Format 

EXAMPLE 



COMM_ORDER, CORD 

Command/Query 



The COMM_ORDER command controls the byte order of wave- 
form data transfers. Waveform data may be sent with the most 
significant byte (MSB) or the least significant byte (LSB) in the 
first position. The default mode is the MSB first. 

COMM_ORDER applies equally to the waveform’s descriptor and 
time blocks. In the descriptor some values are 16 bits long 
(“word”), 32 bits long (“long ” or “float”), or 64 bits long (“dou- 
ble”). In the time block all values are floating values, i.e. 32 bits 
long. When “COMM_ORDER HI” is selected the most significant 
byte is sent first. When “COMM_ORDER LO” is specified the 
least significant byte is sent first. 

The COMM_ORDER? query returns the byte transmission order 
currently in use. 

Note : This command can be executed in both local and remote 
modes . 

Comm_ORDer <mode> 

<mode> := {HI, LO} 

Note : The initial mode, i.e . the mode after power on, is HI. 

Comm_ORDer? 

Comm_ORDer <mode> 

The order of transmission of waveform data depends on the data 
type. Table 3 illustrates the different possibilities. 
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Type 


CORD HI 


CORD LO 


Word 

Long/float 

Double 


<MSBxLSB> 

<MSBxbyte 2xbyte 3xLSB> 
<MSBxbyte 2> ... <byte 7xLSB> 


<LSBxMSB> 

<LSBxbyte 3xbyte 2xMSB> 
<LSBxbyte 7> ... <byte 2xMSB> 



Waveform Data Transmission Order 
Table 3 

RELATED COMMANDS WAVEFORM? 
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COMMUNICATION 



DESCRIPTION 



COMM_RS232, CORS 

Command/Query 



The command COMM_RS232 sets the parameters of the 
RS-232-C port for remote control. 

The COMM_RS232? query reports the settings of the parameters. 

Note: This command is ONLY valid if the oscilloscope is being 
remotely controlled via the RS-232-C port. 

The parameters are: 

a. DUPLEX behavior mode. 

b. End Input character. When received by the oscilloscope, this 
character will be interpreted as the END-of-a-command 
message marker. The commands received will be parsed and 
executed. 

c. End Output string. The oscilloscope will add this string at the 
end of a response message. When the host computer receives 
this string, it knows that the oscilloscope has completed its 
response. 

d. Line Length. This parameter defines the maximum number 
of characters that will be sent to the host in a single line. 
Remaining characters of the response will be output in sepa- 
rate additional lines. This parameter is only applicable if a 
line separator has been selected. 

e. Line Separator. This parameter is used to select the line split- 
ting mechanism and to define the characters used to split the 
oscilloscope response messages into many lines. Possible line 
separators are: CR, LF, CRLF. A <CR>, a <LF> or a <CR> 
followed by a <LF> will be sent to the host computer after 
<linejength> characters. 

f. SRQ string. This string is sent each time the oscilloscope 
wants to signal an SRQ to the host computer. 

Note: Some parameters of this command require ASCII strings as 
actual arguments. In order to facilitate the embedding of non- 
printable characters into such strings , escape sequences may be 
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used, the back-slash character (’V) is used as an escape charac- 
ter. The following escape sequences are recognized: 

“\a Bell character, 

“\b Back space character, 

"\e”: Escape character, 

“\n Line feed character, 

“\r”: Carriage return character, 

“\t Horizontal tab character, 

"\\ The back-slash character itself 

“\ddd ddd represents one to three decimal digit characters giv- 
ing the code value of the corresponding ASCII 
character. This allows any ASCII code in the range l to 
127 to be inserted. 

Before using the string, the oscilloscope will replace the escape 
sequence by the corresponding ASCII character. 

For example, the escape sequences "\r”, “\13” and “\013" are 
all replaced by the single ASCII character <Carriage Return>. 



Notation 








DUPLEX 


duplex 


El 


End input character 


EO 


End output string 


LL 


Line length 


LS 


Line separator 


SRQ 


SRQ Service request 



COMMAND SYNTAX COmm_RS232 DUPLEX, <duplex>,EI,<ei_char>, 

EO,’<eo_string>\LL,<line_length>,LS,<Line_sep>, 

SRQ, ’<srq_string>’ 

<duplex> := FULL (only full duplex is currently implemented) 

<ei_char> := 1 to 126 (default: 13 = <CR>) 

<eo string> := A non-empty ASCII string of up to 20 characters. 

(default: “\n\r”) 

<line_length> := 40 to 1024 (default: 256) 

<line_sep> := {OFF, CR, LF, CRLF} (default: OFF) 

<srq_string> := An ASCII string which may be empty. 

(default: empty string) 
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QUERY SYNTAX 
Response Format 



EXAMPLE 



COmm__RS232? 

COmm_RS232 DUPLEX,<duplex>,EI,<ei_char>, 
EO, M <eo_string>*\ 

LL^lineJength^LS^line^sep^SRQ/^srqLstring:*’” 

After executing the command 

COMM_RS232 EI,3,EO/’\R\NEND\R\N” 

the oscilloscope will assume that it has received a complete mes- 
sage each time the <ETX> (decimal value 3) is detected. Response 
messages will be terminated by sending the character sequence 
“<CRxLF>END<CRxLF>” . 
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ACQUISITION 



COUPLING, CPL 

Command/Query 



DESCRIPTION 



COMMAND SYNTAX 



QUERY SYNTAX 
Response format 

EXAMPLE GPIB) 



The COUPLING command selects the coupling mode of the speci- 
fied input channel. 

The COUPLING? query returns the coupling mode of the speci- 
fied channel. 

<channel>:CouPLing <coupling> 

<channel> := {Cl, C2, C3*, C4*} 

<coupling> := {AIM, DIM, D50, GND} 



<channel>: CouPLing? 
<channel>:CouPLing <coupling> 



The following command sets the coupling of Channel 2 to 
50 O DC. 

CMD$=”C2:CPL D50”: CALL IBWRT(SCOPE%,CMD$) 



t 4-channel oscilloscopes only 
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CURSOR 

DESCRIPTION 



COMMAND SYNTAX 

QUERY SYNTAX 
Response Format 

EXAMPLE (GPIB) 



RELATED COMMANDS 



CURSORMEASURE, CRMS 

Command/Query 



The CURSOR_MEASURE command specifies the type of cursor 
to be displayed. 

The CURSOR_MEASURE? query indicates which cursors are 
currently displayed. 



Notation 






HABS 


Horizontal absolute 


HREL 


Horizontal relative 


VABS 


Vertical absolute 


VREL 


Vertical relative 


PARAM 


Parameters 


OFF 


Cursors off 


PASS 


Pass test 


FAIL 


Fail test 


SHOW 


Extended parameters display 





Note: The PARAM mode is turned OFF when the XV mode is ON. 



CuRsor_MeaSure <mode> 

<mode> := {HABS, VABS, HREL, VREL, PARAM, OFF, PASS, 
FAIL, SHOW} 

CuRsor_MeaSure? 

CuRsor_MeaSure <mode> 

The following command switches on the vertical relative cursors. 

CMD$=”CRMS VREL”: CALL IBWRT(SCOPE%,CMD$) 

The following command determines which cursor is currently 
turned on. 

CMDS$=”CRMS?” : CALL IBWRT(SCOPE%,CMD$) 

CALL IBRD(SCOPE%,RD$): PRINT RD$ 

Example of response message 
CRMS OFF 

CURSOR_MEASURE, CURSOR_SET, 
PASS_FAIL_COUNTER, PASS_FAIL_DO, 
PASS_FAIL_MASK, PARAMETER_VALUE7 
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CURSOR 



DESCRIPTION 



t 4-channel oscilloscopes only 



CURSORJSET, CRST 

Command/Query 



The CURSOR_SET command allows the user to position any one 
of the eight independent cursors at a given screen location. The 
positions of the cursors can be modified or queried even if the 
required cursor is not currently displayed on the screen. 

When setting a cursor position, a trace must be specified, relative 
to which the cursor will be positioned. 

The CURSOR_SET? query indicates the current position of the 
cursor (s). The values returned depend on the grid type selected. 

Note 1: When the oscilloscope is in the dual grid mode , traces are 
assigned to either the upper grid (EA, MC, FE, Cl, C3$) or lower 
grid ( EB , MD, FF, C2, C4% ). The trace specified determines 
whether a vertical cursor will be placed relative to the upper or 
lower grid . 

In quad grid modet each channel is permanently assigned to its 
respective grid with Cl at the top and C4 at the bottom. All other 
traces may be re-positioned anywhere on the screen using the ver- 
tical position control. 

Note 2: If the parameter display is turned on (or the pass fail dis- 
play or the extended parameters display ), the parameters of the 
specified trace will be shown unless the newly chosen trace is not 
displayed or has been acquired in sequence mode (these condi- 
tions will produce an environment error , see Table 6, page 84). To 
only change the trace without repositioning the cursors, the CUR- 
SORJSET command may be given with no argument, ( e.g . 
EBiCRST), 



Notation 






HABS Horizontal absolute 
VABS Vertical absolute 
HREF Horizontal reference 


HDIF 


Horizontal difference 


VREF Vertical reference 


VDIF 


Vertical difference 


PREF Parameter reference 


PDIF 


Parameter difference 
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COMMAND SYNTAX 



QUERY SYNTAX 



Response Format 



EXAMPLE (GPIB) 



RELATED COMMANDS 



<trace>:CuRsor_SeT <cursor>,<position>[<cursor>,<position>, 

. . .<cursor>,<position>] 

<trace> := {EA, EB, MC, MD, FE, FF, Cl, C2, C3$, C4$} 
<cursor> := {HABS, VABS, HREF, HDIF, VREF, VDIF, 
PREF, PDIF} 

<position> := 0 to 10 DIV (horizontal) 

-13 to 13 DIV (vertical) 

Note 1: The suffix DIV is optional. 

Note 2: Parameters are grouped in pairs. The first parameter 
specifies the cursor to be modified and the second one indicates its 
new value. Parameters may be grouped in any order and may be 
restricted to those items to be changed. 

<trace>:CuRsor_SeT? [<cursor>, . . .<cursor>] 

<cursor>:= {HABS, VABS, HREF, HDIF, VREF, VDIF, PREF, 
PDIF, ALL} 

<trace>:CuRsor_SeT <cursor>,<position>[<cursor>,<position>, 

. . .<cursor>,<position>] 

If <cursor> is not specified, ALL will be assumed. If the position 
of a cursor cannot be determined in a particular situation, its posi- 
tion will be indicated as UNDEF. 

The following command positions the VREF and VDIF cursors at 
+3 DIV and -7 DIV respectively, using Function E as a reference. 

CMD$=”FE:CRST VREF, 3DIV, VDIF, -7DIV” 

CALL IBWRT(SCOPE%,CMD$) 

CURSOR_MEASURE, CURSOR VALUE?, 
PASS_FAIL_COUNTER, PASS_FAIL_DO, 

PASS FAIL MASK, PARAMETER_VALUE? 



$ 4-channel oscilloscopes only 
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CURSOR 



DESCRIPTION 



QUERY SYNTAX 



Response Format 



EXAMPLE (GPIB) 



RELATED COMMANDS 
$ 4-channel oscilloscopes only 



CURSOR_VALUE? , CRVA? 

Query 



The CURSOR_VALUE? query returns the values measured by 
the specified cursors for a given trace. (The PARAME- 
TER_VALUE? query is used to obtain measured waveform 
parameter values.) 



Notation 






HABS Horizontal absolute 


HREL 


Horizontal relative 


VABS Vertical absolute 


VREL 


Vertical relative 



<trace>:CuRsor_VAlue? [<mode>, . . .<mode>] 

<trace> := {EA, EB, MC, MD, FE, FF, Cl, C2, C3t, C4$} 
<mode> := {HABS, VABS, HREL, VREL, ALL} 

<trace>:CuRsor_VAlue? <mode>[,<hor_value>] ,<ver_value> 

[ , . . . ,<mode> [ , <hor_value>] ,<ver_value>] 

For horizontal cursors, both horizontal as well as vertical values 
are given, whereas for vertical cursors only vertical values are 
given. 

Note: If <mode> is not specified or equals ALL, all the measured 
cursor values for the specified trace are returned. If the value of a 
cursor could not be determined in the current environment, the 
value UNDEF will be returned. 

The following query reads the measured absolute horizontal value 
of the cross-hair cursor (HABS) on Channel 2. 

CMD$=”C2:CRVA? HABS”: CALL IBWRT(SCOPE%,CMD$) 

CALL IBRD(SCOPE%,RSP$): PRINT RSP$ 

Response message 

C2:CRVA HABS, 34. 2 US, 244 MV 

CURSOR_SET 
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MISCELLANEOUS 



DATE 

Command/Query 



DESCRIPTION 



COMMAND SYNTAX 



QUERY SYNTAX 
Response format 

EXAMPLE (GPIB) 



The DATE command changes the date/time of the oscilloscope’s 
internal real time clock. 

The DATE? query returns the current date/time setting. 

DATE <day>,<month>,<year>,<hour>,<minute>,<second> 

<day> := 1 to 31 

<month> := {JAN, FEB, MAR, APR, MAY, JUN, JUL, 

AUG, SEP, OCT, NOV, DEC} 

<year> := 1987 to 2500 
<hour> := 0 to 23 
<minute> := 0 to 59 
<second> := 0 to 59 

Note: It is not always necessary to specify all the DATE parame- 
ters. Only the parameters up to and including the parameter to be 
changed need to be specified, i.e. to change the “year" setting 
specify day, month and year together with the required settings. 
The time settings will remain unchanged. To change the “second" 
setting all the DATE parameters must be specified with the re- 
quired settings. 

DATE? 

DATE <day>,<month>,<year>,<hour>,<minute>,<second> 

This example will change the date to October 1,88 and the time to 
1:21:16 p.m. (13:21:16 in 24 hour notation). 

CMD$=”DATE 1, OCT, 1988, 13,21, 16” 

CALL IBWRT(SCOPE%,CMD$) 
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STATUS 

DESCRIPTION 

QUERY SYNTAX 
Response format 

EXAMPLE (GPIB) 
RELATED COMMANDS 



DDR? 

Query 



The DDR? query reads and clears the contents of the Device De- 
pendent or device specific error Register (DDR) . In the case of a 
hardware failure, the DDR register specifies the origin of the fail- 
ure. Refer to Table 4, page 66, for further details. 

DDR? 

DDR <value> 

<value> := 0 to 65535 

The following instruction reads the contents of the DDR register. 

CMD$=”DDR?”: CALL IBWRT(SCOPE%,CMD$) 

CALL IBRD (SCOPES, RSP$): PRINT RSP$ 

Response message 
DDR 0 

ALL_ST ATU S? , »CLS 
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Bit 


Bit Value 


Description 


15. .14 




0 


Reserved 


13 


8192 


1 


time-base hardware 
failure is detected 


12 


4096 


1 


a trigger hardware 
failure Is detected 


11 


2048 


1 


a Channel 4$ hardware 
failure is detected. 


10 


1024 


1 


a Channel 3$ hardware 
failure is detected. 


9 


512 


1 


a Channel 2 hardware 
failure is detected 


6 


256 


1 


a Channel 1 hardware 
failure Is detected 


7. .4 




0 


Reserved 


3 


8 


1 


a Channel 4J overload 
condition is detected 


2 


4 


1 


a Channel 3$ overload 
condition is detectedl 


1 


2 


1 


a Channel 2 overload 
condition is detected 


0 


1 


1 


a Channel 1 overload 
condition is detected 



Device Specific Register Structure (DDR) 
Table 4 



t 4-channel oscilloscopes only, reserved in the 2-channel oscilloscopes 

a 



■ 



66 





































System Commands 



FUNCTION 

DESCRIPTION 



COMMAND SYNTAX 



QUERY SYNTAX 
Response format 

$ 4-channel oscilloscopes only 



DEFINE, DEF 

Command/Query 

Standard Oscilloscopes 



The DEFINE command specifies the mathematical expression to 
be evaluated by a function. 



Notation 




MAXPTS 


maximum number of points 


SWEEPS 


maximum number of sweeps 


EQN 


equation AVGS average summed 


Cl 


Channel 1 C2 Channel 2 


C3 


Channel 3$ C4 Channel 4$ 



<function>:DEFine EQN,’<equation> , ,MAXPTS,<max_points>, 
SWEEPS, <max_sweeps> 

<function> := {MC$, MDJ, FE, FF} 

<equation> := {<source>, - <source>, <source> + <source>, 
<source> - <source>, AVGS (<source>)} 

<source> := {Cl, C2, C3$, C4$} 



<max_points> := 



<max_sweeps> := 

Note 1: Parameters are grouped in pairs . The first one names the 
variable to be modified and the second one gives the new value to 
be assigned , Pairs may be given in any order and may be restricted 
to the variables to be changed. 

Note 2: The pair SWEEPS ,<max_sweeps> applies only when aver- 
aging (AVGS) has been chosen. Otherwise it is ignored . 



9410/14 


All others 


50 to 10000 


50 to 50000 



1 to 1000 



<function>:DEFine? 

<function>:DEFine EQN,'<equation>\MAXPTS,<max_points> 
[, SWEEPS, <max_sweeps>] 
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EXAMPLE (GPIB) 



RELATED COMMANDS 



$ 4-channel oscilloscopes only 



The following command defines Function E (FE) to compute the 
summed average of Channel 1 using 5000 points over 200 sweeps. 

CMD$=”FE:DEF EQN,’AVGS(C1)\ 

MAXPTS, 5000, SWEEPS, 200” 

CALL IB WRT (SCOPE%,CMD$) 

FUNCTION_RESET, FUNCTION_STATEt . INR? 
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FUNCTION 



DESCRIPTION 



DEFINE, DEF 

Command/Query 
Oscilloscopes fitted with the WP01 Option 



An oscilloscope fitted with the Waveform Processing option 
(WP01) accepts additional forms of the DEFINE command: 



Processing Notation 


ABS 


Absolute Value 


AVGC 


Continuous Average 


AVGS 


Summed Average 


DERI 


Derivative 


EXP 


Exponential (power of e) 


EXP10 


Exponential (power of 10) 


EXTR 


Extrema 


FLOOR 


Floor (Extrema only) 


ERES 


Enhanced Resolution Filter 


INTG 


Integral 


LOG 10 


Logarithm base 10 


LN 


Logarithm base e 


ROOF 


Roof (Extrema only) 


SQR 


Square 


SORT 


Square Root 


+ 


Identity or Add 


- 


Negation or Subtract 


* 


Multiply 


/ 


Ratio 


1/ 


Reciprocal 
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i 



Key words 




BITS 


Resolution enhancement bits (Enhanced 
Resolution only) 


DITHER 


Dither (Summed Average only) 


MAXPTS 


Maximum number of points 


REJECT 


Reject overflow/underflow (Summed Aver- 
age only) 


SWEEPS 


Maximum number of sweeps (Average and 
Extrema only) 


WEIGHT 


Weight (Continuous Average only) 



COMMAND SYNTAX <function>:DEFine EQN,*<equation>’, MAXPTS,<max_points>, 

SWEEPS, <max_sweeps>, DITHER, <off_on>, 

REJECT, <off_on>, WEIGHT, <weight>, BITS,<bits> 

<function> := {MCt, MDJ, FE, FF} 

<equation> := AVGS(<source>) Summed Average 

<equation> := AVGC(<source>) Continuous Average 

<equation> := <paren_source_expr> Identity 

<equation> := +<paren_source_expr> Identity 

<equation> := -<paren_source_expr> Negation 

<equation> := l/<paren_source_expr> Reciprocal 

<equation> := <paren_source_expr> + <source> 

Addition 

<equation> := <paren_source_expr> - <source> 

Subtraction 

<equation> := <paren_source_expr> * <source> 

Multiplication 

<equation> := <paren_source_expr> / <source> 

Ratio 

<equation> := EXTR(<source>) Extrema (R+F) 

t 4-channel oscilloscopes only 
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<equation> := FLOOR(EXTR(<source>)) Floor 

<equation> := ROOF(EXTR(<source>)) Roof 

<equation> := SQR(<source_expr>) Square 

<equation> := SQRT(<source_expr>) Square Root 

<equation> := LN(<source_expr>) Logarithm base e 

<equation> := LOG10(<source_expr>) Logarithm base 10 

<equation> := EXP(<source_expr>) Power of e 

<equation> := EXP10(<source_expr>) Power of 10 

<equation> := INTG(<source_expr>) Integral 

<equation> := DERI (<source_expr>) Derivative 

<equation> := ABS(<source_expr>) Absolute Value 

<equation> := ERES(<source>) Enhanced Resolution 

<paren_source_expr> := (<source_expr>) 

<paren_source_expr> := <source> 

<source_expr> := <multiplier> * <source> {+, -} <addend> 
<source_expr> := <multiplier> * <source> 

<source_expr> := <source> {+, -} <addend> 

<source_expr> := <source> 

<multiplier> := 0.001e-33 to 999.999e33 

<addend> := - 999.999e33 to 999.999e33 

<source> := {EA, EB, MC, MD, FE, FF, Cl, C2, C3*. C4$} 

<max_points> := 

<max_sweeps> := 

<off_on> := {OFF, ON} 

<weight> := {1, 3, 7, 15, 31, 63, 127, 255, 511, .1023} 

<bits> := {0.5, 1.0, 1.5, 2.0, 2.5, 3.0} 

Note: Space (blank) characters inside equations are optional. 

% 4-channel oscilloscopes only 



9410/14 


All others 


50 to 10000 


50 to 50000 



1 to 1000000 
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QUERY SYNTAX 
Response format 

EXAMPLE (GPIB): 



RELATED COMMANDS 



$ 4-channel oscilloscopes only 



<function>:DEFINE? 

<function>:DEFine EQN,’<equation>\ MAXPTS,<max_points>, 
SWEEPS, <max_sweeps>, DITHER, <off_on>, 

REJECT, <off_on>, WEIGHT, <weight>, BITS,<bits> 

The following command defines Function E to compute the prod- 
uct of (Channel 1 multiplied by 2.1 and augmented by 3.3) and 
Channel 2, using a maximum of 10000 input points: 

CMD$=”FE:DEF EQN,’(2. 1 *0+3.3) *C2\ MAXPTS, 10000” 

CALL IBWRT(SCOPE%,CMD$) 

FUNCTION_RESET, FUNCTION^STATE*, INR? 
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FUNCTION 



DESCRIPTION 



COMMAND SYNTAX (FFT) 



t 4-channel oscilloscopes only 



DEFINE, DEF 

Command/Query 



Oscilloscopes fitted with the WP02 Option 



An oscilloscope fitted with the FFT option (WP02) accepts addi- 
tional forms of the DEFINE command. 



Notation 




WINDOW 


FFT window function 


FFT 


Fast Fourier Transform (complex result) 


REAL 


Real part of complex result 


IMAG 


Imaginary part of complex result 


MAG 


Magnitude of complex result 


PHASE 


Phase angle (degrees) of complex result 


PS 


Power Spectrum 


PSD 


Power Density 


AVGP 


Power Average 


RECT 


Rectangular window 


HANN 


von Hann window 


HAMM 


Hamming window 


FLTP 


Fiat Top window 


BLHA 


Blackman-Harris window 


DCSUP 


DC component suppression 



< function > :DEFine EQN,’ < equation > 

M AXPTS, < max_points > , WINDOW, < window_type > , 
DCSUP, < off_on > 

<function> := {MC$, MDi, FE, FF} 

<equation> := FFT(<source_expr>) 

<equation> := REAL (FFT (<source_expr>)) 

<equation> := IMAG(FFT(<source_expr>)) 

<equation> := MAG(FFT(<source_expr>)) 

<equation> := PHASE (FFT (<source_expr>)) 

<equation> := PS(FFT(<source_expr>)) 

<equation> := PSD(FFT(<source_expr>)) 

<source_expr> := <multiplier> * <source> {+, -} <addend> 
<source_expr> := <multiplier> * <source> 
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<source_expr> := <source> {+, -} <addend> 

<source_expr> := <source> 

<multiplier> := 0.001e-33 to 999.999e33 

<addend> := -999.999e33 to 999.999e33 

<source> := {EA, EB, MC, MD, FE, FF, Cl, C2, C3$, C4*} 

<window_type> := {RECT, HANN, HAMM, FLTP, BLHA} 

<off_on> := {OFF, ON} 



<max_points> := 



9410/14 


Alt others 


50 to 10000 


50 to 50000 



Note : The source waveform must be a time domain signal . 



QUERY SYNTAX 
Response Format 



EXAMPLE (GPIB) 



COMMAND SYNTAX 
(FFT Power Average) 



<function>: DEFine? 

<function>:DEFine EQN, *<equation>’ ,MAXPTS,<max_points>, 
WINDOW, <window_type>,DCSUP,<off_on> 

The following command defines Function E to compute the Power 
Spectrum of the FFT of Channel 1. Prior to FFT computation, 
Channel 1 is multiplied by 1.018 and 0.055 (units of Channel 1, 
i.e. Volts) is added. A maximum of 1000 points will be used for 
the input. The window function is Rectangular. The DC compo- 
nent of the input is not suppressed. 

CMD$=”FE:DEF EQN, *PS(FFT(1. 018*0 + 0.055))*, 
MAXPTS, 1000, WINDOW, RECT, DCSUP, OFF” 

CALL IBWRT(SCOPE%,CMD$) 



< function > :DEFine EQN,* < equation > \ 

SWEEPS, < maxsweeps > 

<equation> := MAG(AVGP(<source>)) 

<equation> := PS(AVGP(<source>)) 

<equation> := PSD(AVGP(<source>)) 

<source> := {MC$, MDJ, FE, FF} 

<max_sweeps> := 1 to 50000 

Note: The source waveform must be another function defined as a 
Fourier transform . 



t 4-channel oscilloscopes only 



74 




System Commands ^ 



QUERY SYNTAX 
Response Format 

EXAMPLE (GPIB) 
RELATED COMMANDS 



t 4-channel oscilloscopes only 



<function>:DEFine? 

<function>:DEFine EQN,'<equation>*,S WEEPS, <max_sweeps> 

The following command defines Function F to compute the Power 
Spectrum of the Power Average of the FFT being computed by the 
Function E, over a maximum of 244 sweeps. 

CMD$=” FF:DEF EQN,TS(AVGP(FE)) '.SWEEPS, 244” 

CALL IB WRT (SCOPE%,CMD$) 

FUNCTION_RESET, FUNCTION_STATEJ , INR? 



75 



System Commands 



MISCELLANEOUS 



DESCRIPTION 



COMMAND SYNTAX 



EXAMPLE (GPIB) 



RELATED COMMANDS 



DELETEJFILE, DELF 

Command 

Oscilloscopes fitted with the MC01 Option 



The DELETEJFILE command deletes all waveforms, only 44 Auto- 
stored” waveforms, or only a single file from the memory card. 



Notation 




WF 


all waveforms 


AUTOWF 


all “autostored” waveforms 



DELete_file FILE, <mode> 

<mode> := {WF, AUTOWF, ’<filename>’} 

<filename> := an alphanumeric string of up to 8 characters, fol- 
lowed by a dot and an extension of up to 3 digits. 

The following commands first delete a front-panel setup, and then 
delete all the “autostored" waveforms from the card: 

CMD$=”DELF FILE, 4 P001.PNL’; DELF FILE, AUTOWF" 
CALL IBWRT(SCOPE%,CMD$) 

DIRECTORY_LIST, FORMAT_CARD 
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MISCELLANEOUS 



DESCRIPTION 



QUERY SYNTAX 
Response format 



EXAMPLE (GPIB) 



DIRECTORY_LIST?, DIR? 

Query 

Oscilloscopes fitted with the MC01 Option 

The DIRECTORY_LIST? query produces a directory listing of the 
memory card. The response consists of a double-quoted string 
containing a DOS-like listing of the directory. If no memory card 
is present, or if it is not formatted, the string will be empty. 

DIRectoryJist? 

DIRectory_list? “<directory>” 

<directory>:= a variable length string detailing the file content of 
the memory card. 

The following code asks for a listing of the directory of the memory 
card. 

CMD$=”DIR?”: CALL IBWRT(SCOPE%,CMD$) 

CALL IBRD (SCOPE%,RSP$): PRINT RSP$ 

Response message 
DIR ” 

Memory card of 25-JAN-1991 12:10:40 

1 SCI 001 29-JAN-1991 16:33:06 20361 

2 SC2 001 29-JAN-1991 16:34:32 20361 
2 File(s) 84992 bytes free 
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DISPLAY 



DISPLAY, DISP 

Command/Query 



DESCRIPTION 



COMMAND SYNTAX 

QUERY SYNTAX 
Response Format 

EXAMPLE (GPIB) 



The DISPLAY command controls the display screen of the oscillo- 
scope. When the user is remotely controlling the oscilloscope and 
does not need to use the display, it may be useful to switch off the 
display via the DISPLAY OFF command. This improves instru- 
ment response time since the waveform graphic generation 
procedure is suppressed. 

The response to the DISPLAY? query indicates the display state of 
the oscilloscope. 

Note: When the display has been set to OFF, the real time clock 
and the message field are updated. However, the waveforms and 
associated texts remain unchanged. 

DISPlay <state> 

<state> := {ON, OFF} 

DISPlay? 

DISPlay <state> 

The following instruction turns off the display generation. 
CMD$=”DISP OFF”: CALL IBWRT(SCOPE%,CMD$) 
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DISPLAY 

DESCRIPTION 



COMMAND SYNTAX 

QUERY SYNTAX 
Response format 

EXAMPLE (GPIB) 
RELATED COMMANDS 



DUAL_ZOOM, DZOM 

Command/Query 



By setting DUAL_ZOOM ON, the horizontal magnification and 
positioning controls apply to all expanded traces simultaneously. 
This command is useful if the contents of all expanded traces are 
to be examined at the same time. 

The DUAL_ZOOM? query indicates whether multiple zoom is en- 
abled or not. 

Note: This command has the same effect as MULTI JZOOM. 

Dual_ZOoM <mode> 

<mode> := {ON, OFF} 

Dual_ZOoM? 

Dual_ZOoM <mode> 

The following example turns dual zoom on. 

CMD$=”DZOM ON”: CALL IBWRT(SCOPE%,CMD$) 

HOR_MAGNIFY, HOR_POSITION, MULTLZOOM, ZOOM 
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STATUS 

DESCRIPTION 



COMMAND SYNTAX 

QUERY SYNTAX 
Response format 

EXAMPLE (GPIB) 
RELATED COMMANDS 



*ESE 

Command/Query 



The *ESE command sets the standard Event Status Enable regis- 
ter (ESE). This command allows one or more events in the ESR 
register to be reflected in the ESB summary message bit (bit 5) of 
the STB register. For an overview of the ESB defined events refer 
to the ESR table (Table 5, page 82). 

The *ESE? query reads the contents of the ESE register. 

Note: This command can be executed in both local and remote 
modes. 

*ESE <value> 

<value> := 0 to 255 

*ESE? 

*ESE <value> 

The following command allows the ESB bit to be set if a user re- 
quest (URQ bit 6, i.e. decimal 64) and/or a device dependent 
error (DDE bit 3, i.e. decimal 8) occurs. Summing these values 
yields the ESE register mask 64+8=72. 

CMD$=”*ESE 72”: CALL IBWRT(SCOPE%,CMD$) 

•ESR? 
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STATUS 

DESCRIPTION 

QUERY SYNTAX 
Response format 

EXAMPLE (GPIB) 
RELATED COMMANDS 



*ESR? 

Query 



The *ESR? query reads and clears the contents of the Event Status 
Register (ESR). The response represents the sum of the binary 
values of the register bits 0 to 7. Refer to Table 5, page 82 for an 
overview of the ESR register structure. 

*ESR? 

*ESR <value> 

<value> := 0 to 255 

The following instruction reads and clears the contents of the ESR 
register. 

CMD$=”*ESR?”: CALL IBWRT(SCOPE%,CMD$) 

CALL IBRD(SCOPE%,RSP$): PRINT RSP$ 

Response message 
•ESR 0 

ALL_STATUS?, *CLS, *ESE 
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Bit 


Bit Value 


Bit Name 


Description 


Note 


15. .8 






0 Reserved by IEEE 488.2 




7 


128 


PON 


1 a Power off-to-ON transition has occurred 


(D 


6 


64 


URQ 


1 a User ReQuest has been issued 


(2) 


5 


32 


CME 


1 a CoMmand parser Error has been found 


(3) 


4 


16 


EXE 


1 an Execution Error has been detected 


(4) 


3 


8 


DDE 


1 a Device Specific Error has occurred 


(5) 


2 


4 


QYE 


1 a QueRy Error has occurred 


(6) 


1 


2 


RQC 


0 The Instrument never requests bus control 


(7) 


0 


1 


OPC 


0 The Operation Complete bit is not used 


(8) 



Standard Event Status Register (ESR) 
Table 5 



Notes: 

(1) The Power On (PON) bit Is always turned on (1) when the unit is powered up. 

(2) The User Request (URQ) bit is set true (1 ) when a soft key Is pressed. An associated register URR Identifies 
which key was selected. For further details refer to the URR? query. 

(3) The CoMmand parser Error bit (CME) is set true ( 1 ) whenever a command syntax error Is detected. The CME 
bit has an associated CoMmand parser Register (CMR) which specifies the error code. Refer to the query 
CMR? for further details. 

(4) The Execution Error bit (EXE) Is set true (1) when a command cannot be executed due to some device 
condition (e.g. oscilloscope In local state) or a semantic error. The EXE bit has an associated Execution Error 
Register (EXR) which specifies the error code. Refer to query EXR? for further details. 

(5) The Device specific Error (DDE) Is set true (1) whenever a hardware failure has occurred at power-up or 
execution time such as a channel overload condition, a trigger or a time-base circuit defect. The origin of the 
failure may be localized via the DDR? or the self test *TST? query. 

(6) The Query Error bit (QYE) Is set true (1 ) whenever (a) an attempt Is being made to read data from the Output 
Queue when no output Is either present or pending, (b) data in the Output Queue has been lost, (c) both 
output and Input buffers are full (deadlock state) , (d) an attempt Is made by the controller to read before 
having sent an<END>, (e) a command Is received before the response to the previous query was read (output 
buffer flushed) . 

(7) The ReQuest Control bit (RQC) Is always false (0) since the oscilloscope has no GPIB controlling capability. 

(8) The Operation Complete bit (OPC) Is set true (1) whenever *OPC has been received since commands and 
queries are strictly executed In sequential order. The oscilloscope starts processing a command only once the 
previous command has been entirely executed. 
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STATUS 

DESCRIPTION 

QUERY SYNTAX 
Response format 

EXAMPLE (GPIB) 
RELATED COMMANDS 



EXR? 

Query 



The EXR? query reads and clears the contents of the Execution 
error Register (EXR). The EXR register specifies the type of the 
last error detected during execution. Refer to Table 6, page 84 for 
further details. 

EXR? 

EXR <value> 

<value> := 21 to 64 

The following instruction reads the contents of the EXR register. 

CMD$=” *EXR?” : CALL IBWRT(SCOPE%,CMD$) 

CALL IBRD(SCOPE%,RSP$): PRINT RSP$ 

Response message (if no fault) 

EXR 0 

ALL_STATUS?, *CLS 
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Value Description 

21 Permission error. The command cannot be executed in local mode. 

22 Environment error. The instrument is not configured to correctly process a command. 
For instance, the oscilloscope cannot be set to RIS at a slow time base. 

23 Option error. The command applies to an option which has not been installed. 

24 Unresolved parsing error. 

25 Parameter error. Too many parameters specified. 

26 Non-implemented command. 

30 Hex data error. A non-hexadecimal character has been detected in a hex data block. 

31 Waveform error. The amount of data received does not correspond to descriptor indi- 
cators. 

32 Waveform descriptor error. An invalid waveform descriptor has been detected. 

33 Waveform time error. Invalid RIS or TRIG time data has been detected. 

34 Waveform data error. Invalid waveform data have been detected. 

35 Panel setup error. An invalid panel setup data block has been detected. 

50 No memory card present when user attempted to access the card.* 

51 Memory card not formatted when user attempted to access the card.* 

52 Memory card was exchanged when user attempted to RECALL the NEXT, PREVIOUS 
or SAME waveform.* 

53 Memory card was write protected when user attempted to create a file, to delete a 
file, or to format the card.* 

54 Bad memory card detected during formatting.* 

55 Memory card root directory full. LECROY_1.DIR subdirectory cannot be created.* 

56 Memory card full when user attempted to write to It.* 

57 Memory card file sequence numbers exhausted (999 reached).* 

58 Memory card file not found.* 

59 Attempt to retrieve a file from memory card that is neither a waveform nor a panel.* 

60 Memory card file is write protected (DOS Read/Only attribute).* 

61 Memory card filename not DOS compatible, or waveform filename begins with an 
"A\* 

62 A retrieved panel or waveform contains invalid bytes, or a waveform is too long for the 
instrument.* 

64 Read/Write outside of memory card cluster chains. Can indicate a corrupted FAT 
table. 

Can also indicate a waveform or panel file with a length shorter than the internal byte 
count.* 



Execution Error Status Register Structure (EXR) 
Table 6 



* only oscilloscopes equipped with the memory card option 



■ 
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MISCELLANEOUS 

DESCRIPTION 

COMMAND SYNTAX 

QUERY SYNTAX 
Response format 



FO RM AT_C ARD , FCRD 

Command/Query 

Oscilloscopes fitted with the MC01 Option 



The FORMAT__CARD command formats the memory card ac- 
cording to the PCMIA/JEIDA standard with a DOS partition. 

The FORMAT_CARD? query returns the status of the card. 

Format_CaRD 

Format_CaRD? 

Format_CaRD <card_status>[,<read/write>,<free_space>, 
<card_siz e> , <batter y_status>] 

<card_status> := {NC, BAD, BLANK, UNKNOWN _FMT, 
DIR_MISSING, OK} 

<read/write> := {WP, RW} 

<free_space> := a decimal number giving the number of bytes 
still available on the card. 

<card_size> := a decimal number giving the total number of 
bytes on the card. 

<battery_status> := {BAT_OK, BAT_LOW, BAT_BAD} 



Notation 




NC 


No card. 


BAD 


Bad card after formatting. 


BLANK 


Empty card. 


UNKNOWNJMT 


Valid PCMIA format, but not supported. 


DIR MISSING 


No “LECROY 1_DIR" subdirectory pres- 




ent. It will be automatically created with 
the next “store" command. 


OK 


The card Is correctly formatted. 


WP 


Write protected. 


RW 


Read/ Write authorized. 


BAT_OK 


The battery is in order. 


BAT_LOW 


The battery should be replaced. 


BAT_BAD 


Bad battery or no battery. 
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EXAMPLE (GPIB) 



RELATED COMMANDS 



The following code will first format a memory card and then verify 
its status. 

CMD$=”FCRD”: CALL IBWRT(SCOPE%,CMD$) 
CMD$=’’FCRD?”: CALL IBWRT(SCOPE%,CMD$) 

CALL IBRD(SCOPE%,RSP$): PRINT RSP$ 

Response message 

FCRD OK.RW, 130048, 131072, BAT_OK 



DIRECTORY LIST 
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FUNCTION 

DESCRIPTION 

COMMAND SYNTAX 
EXAMPLE (GPIB) 



RELATED COMMANDS 



FU N CTI O N_RES ET , FRST 

Command 



The FUNCTION_RESET command resets a waveform processing 
function. The number of sweeps will be reset to zero and the proc- 
ess restarted. 

<function>: Function_Re SeT 
<function> := {MC$, MD$, FE, FF} 

Assuming that Function E (FE) has been defined as the summed 
average o | Channel 1 , (he following example will restart the aver- 
aging process. 

CMD$=”FE:FRST”: CALL IBWRT(SCOPE%,CMD$) 

DEFINE, INR? 



t 4-channel oscilloscopes only 



§ System Commands 



FUNCTION 



DESCRIPTION 



COMMAND SYNTAX 



t 4-channel oscilloscopes only 



FUNCTION_STATE, FSTA$ 

Command/Query 



The FUNCTION_STATE command allows the user to control or 
enquire how Functions C, D, E and F are being used. The four 
waveform processing functions may assume up to three different 
states: 

MEM static memory of a waveform (no further automatic pro- 
cessing occurs) 

ZOOM expansion of another waveform (updated as the source 
changes) 

FUNC a mathematical function of one or two other waveforms 
(updated if one of the sources change) 

The two Functions C and D may assume all three states whereas E 
and F may assume only the states MEM and FUNC. The setup 
information needed to execute expansions or mathematical wave- 
form processing is memorized separately by the oscilloscope for 
each function. When the state of a function is changed, the last 
setup information associated with the new state will be reactivated. 

There are three other commands which may cause a state transi- 
tion. The command ZOOM applied to Functions C or D will 
automatically switch them into zoom state. The commands 
STORE (storage from internal waveform) and WAVEFORM 
(storage from external waveform) applied to any one of the Func- 
tions C, D, E or F will automatically switch them into the memory 
state. There is never an automatic transition into the function 
state. The command FUNCTION_STATE must be used. 

Initially Functions C and D are set to the memory state and Func- 
tions E and F are set to the function state. 

The query FUNCTION_STATE returns the current state of a 
waveform processing function. 

<function>:Function_STAte <state> 

<function> := {MC, MD, FE, FF} 

<state> {FUNC, MEM, ZOOM} 
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QUERY SYNTAX 
Response format 

EXAMPLE (GPIB) 
RELATED COMMANDS 



<function>: Function_ST Ate? 

<function>:Function_STAte <state> 

The following example switches the internal function memory C 
into the mathematical waveform processing state thereby re-estab- 
lishing the last valid waveform processing definition. 

CMD$=”MC:FSTA FUNC”: CALL IBWRT(SCOPE%,CMD$) 
DEFINE, STORE, WAVEFORM, ZOOM 



89 



System Commands 



DISPLAY 

DESCRIPTION 



COMMAND SYNTAX 

QUERY SYNTAX 
Response Format 

EXAMPLE (GPIB) 



t 4-channel oscilloscopes only 



GRID 

Command/Query 



The GRID command specifies whether the grid should be dis- 
played in single, dual or quad$ mode. 

In single grid mode all the traces are displayed on a single grid. 

In dual grid mode the screen is split into two distinct grids to sepa- 
rate the traces. In the dual-channel oscilloscopes, Channel 1 is 
always displayed in the upper grid and Channel 2 in the lower grid. 
In the 4-channel oscilloscopes, Channels 1 and 2 are always dis- 
played in the upper grid and Channels 3 and 4 in the lower grid. 
All other waveforms can be vertically positioned anywhere. 

In quad grid modet Channel 1 is always displayed in the upper 
grid, Channel 2 in the second grid, etc. All other waveforms can 
be vertically positioned anywhere. 

The GRID? query returns the grid mode currently in use. 

GRID <grid> 

<grid> := {SINGLE, DUAL, QUAD*} 

GRID? 

GRID <grid> 

The following command sets the screen display to dual grid mode. 
CMD$=” GRID DUAL”: CALL IBWRT(SCOPE%,CMD$) 
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HARD COPY 



DESCRIPTION 



COMMAND SYNTAX 



System Commands £ 



HARDCOPY_SETUP, HCSU 

Command/Query 



The HARDCOPY_SETUP command configures the instrument's 
hard copy driver. The command enables the user to specify the 
device type, transmission mode, plot size etc. of the hard-copy 
unit connected to the oscilloscope. 

The command allows one or more individual settings to be 
changed by specifying the appropriate keyword (s) together with 
the new value (s). For instance, to select the Graphtec FP5301 
plotter with normal speed, the command may be restricted to: 

HCSU DEV, FP5301, SPEED, N 



Notation 








DEV 


device 


PORT 


port 


SPEED 


plot speed 


DENS 


print density 


PENS 


plot pens 


PFEED 


page feed 


PSIZE 


paper size 


GRID 


grid square 


LLX 


lower left X 


LLY 


lower left Y 


FP5301 


Graphtec FP5301 


PM8151 


Philips PM8151 


HP7470A 


HP 7470A 


HP7550A 


HP 7550A 


HPQJ 


HP QuietJet 


HPTJ 


HP ThinkJet 


HPLJ 


HP LaserJet 


EPSON 


Epson FX80 


N 


Normal 


NS 


Non-standard 


L 


Low 







HardCopy_SetUp DEV,<device>, PORT,<port> 

, SPEED, <plot_speed>, 

DEN S , <pr int_density>, PEN S ,<plot_pens>, 
PFEED,<page_feed>, PSIZE,<paper_size>, 
GRID,<grid_square>, LLX,<lower_left_X>, 
LLY,<lower_left_Y> 

Note: Parameters are grouped in pairs . The first one names the 
variable to be modified and the second one gives the new value to 
be assigned. Pairs may be given in any order and may be restricted 
to those variables to be changed. 
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QUERY SYNTAX 
Response format 

EXAMPLE (GPIB) 
RELATED COMMANDS 



<device> := {FP5301, PM8151,*HP7470A, HP7550A, HPQJ, 
HPTJ, HPLJ, EPSON} 

<port> := {GPIB, RS} 

<plot_speed> := {N, L} for plotters only 

<density> := {SINGLE, DOUBLE, QUADRUPLE, 
HIGH_SPEED,HIGH_RESOLUTION, 
ONE_TO_ONE , TWO_TO_ONE,CRT} 

for printers only 

<plot_pens> := 1 to 8 
<page_feed> := {ON, OFF} 

<paper_size> := {A5, A4, A3, NS} 

<grid_square> := 0.0 to 99.9 MM 'j 

dower left X>:= -999 to 999 MM ) for non-standard 
- ~ [ paper size only 

<lower_left_Y> := -999 to 999 MM/ 

Note: For these three parameter values the suffix is optional. 
The suffix M is assumed. 



HardCopy_SetUp? 

HardCopy_SetUp DEV,<device>,PORT,<port>, 

SPEED, <plot_speed>, DENS, <print_density>, PENS, <plot_pens>, 
PFEED,<page_feed>,PSIZE,<paper_size>,GRID,<grid_square>, 
LLX,<lower_left_X>,LLY,<lower_left_Y> 

This example selects a HP 7550A plotter to be driven by the GPIB 
port. 

CMD$=”HCSU PORT, GPIB, DEV, HP7550A” 

CALL IBWRT(SCOPE%,CMD$) 

HARDCOPY TRANSMIT, SCREEN_DUMP 



92 




System Commands 



HARD COPY 
DESCRIPTION 

COMMAND SYNTAX 
EXAMPLE (GPIB) 



RELATED COMMANDS 



HARDCOPY TRANSMIT, HCTR 

Command 



The HARDCOPYJTRANSMIT command sends a string of ASCII 
characters without modification to the hard-copy unit. This allows 
the user to control the hard-copy unit by sending device specific 
control character sequences. It also allows the user to place addi- 
tional text on a screen dump for documentation purposes. This 
command accepts the escape sequence “\ddd” like those de- 
scribed under the command COMM_RS232 (see page 56). 
Before sending the string to the hard-copy unit the escape se- 
quence is converted to the ASCII character code. 

HardCopy_TRansmit ’<string>’ 

<string> := Any sequence of ASCII or escaped characters. 

The following code sends documentation data to a printer. 

CMD$=”HCTR ’Data from Oct.l5\r\n”’ 

CALL IBWRT(SCOPE%,CMD$) 

The following code sends the same documentation data to an 
HP7470A plotter using pen 1. The text will be printed at the lower 
left corner of the paper. 

CMD$= 

”HCTR ’ IN;SP1 ;PA0,0;PD;LBData from Oct. 15 \03IN;SP0;PA0,0’ ” 
CALL IBWRT(SCOPE%,CMD$) 

HARDCOPY_SETUP, SCREEN_DUMP 
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DISPLAY 

DESCRIPTION 



COMMAND SYNTAX 



QUERY SYNTAX 
Response Format 

EXAMPLE (GPIB) 
RELATED COMMANDS 



i 4-channel oscilloscopes only 



HOR_MAGNIFY, HMAG 

Command/Query 



The HOR_MAGNIFY command horizontally expands the se- 
lected expansion trace by a specified factor. Magnification factors 
which are not within the range of permissible values will be 
rounded to the closest legal value. 

If multiple zoom is enabled, the magnification factor for all expan- 
sion traces is set to the specified factor. If the specified factor is too 
large for any of the expanded traces (depending on their current 
source), it is reduced to an acceptable value and only then applied 
to the traces. 

The VAB bit (bit 2) in the STB register (Table 8, page 137 ) is set 
if a factor outside the legal range is specified. 

The HOR_MAGNIFY query returns the current magnification 
factor for the specified expansion function. 

<exp_trace> 

<exp_trace> 



<factor> := 



<exp_source>: Hor_M AGnify? 

<exp_source>:Hor_MAGnify <factor> 

The following example horizontally magnifies Expand B (EB) by a 
factor of 5. 

CMD$=”EB:HMAG 5”: CALL IBWRT(SCOPE%,CMD$) 
DUAL_ZOOM, ZOOM 



:Hor_MAGnify <factor> 

:= {EA, EB, MCt, MD*} 



9410/14 


All others 


1 to 200 


1 to 1000 
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System Commands 



DISPLAY 



DESCRIPTION 



COMMAND SYNTAX 



t 4-channel oscilloscopes only 



HOR_POsrnoN, hpos 

Command/Query 



The HORJPOSITION command horizontally positions the geo- 
metric center of the intensified zone on the source trace. Allowed 
positions range from division 0 through 10. If the source trace was 
acquired in sequence mode, horizontal shifting will only apply to a 
single segment at a time. 

If the multiple zoom is enabled, the difference between the speci- 
fied and the current horizontal position of the specified trace is 
applied to all expanded traces. If this would cause the horizontal 
position of any expanded trace to go outside the left or right screen 
boundaries, the difference of positions is adapted and then applied 
to the traces. 

If the sources of expanded traces are sequence waveforms, and 
the multiple zoom is enabled, the difference between the specified 
and the current segment of the specified trace is applied to ail ex- 
panded traces. If this would cause the segment of any expanded 
trace to go outside of the range of the number of segments of 
sources, the difference is adapted and then applied to the traces. 

The VAB bit (bit 2) in the STB register (Table 8, page 137 ) is set 
if a value outside the legal range is specified. 

The HOR_POSITION query returns the position of the geometric 
center of the intensified zone on the source trace. 

<exp_t ra ce> : H°r_POSition <hor_position>,<segment> 

<e xp_trac e> := {EA, EB, MC$, MDt} 

<hor_position> := 0 to 10 DIV 
<segment> := 1 to 200 

Note 1: The suffix DIV is optional. 

Note 2: The segment number is only relevant for waveforms ac- 
quired in sequence mode . The segment number is ignored in single 
waveform acquisitions . 
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^ System Commands 



QUERY SYNTAX 
Response Format 

EXAMPLE (GPIB) 
RELATED COMMANDS 



<exp_trace>:Hor_POSition? 

<exp_trace>:Hor_POSition <hor_position>, [<segment>] 

Note: The segment number is only given for sequence waveforms. 

The following example positions the center of the intensified zone 
on the trace currently viewed by Expand A (EA) at division 3. 

CMD$=”EA:HPOS 3”: CALL IBWRT(SCOPE%,CMD$) 
DUAL_ZOOM, ZOOM 
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System Commands £ 



MISCELLANEOUS 

DESCRIPTION 

QUERY SYNTAX 
Response format 



EXAMPLE (GPIB) 



*IDN? 

Query 



The *IDN? query is used for identification purposes. The response 
consists of four different fields providing information on the manu- 
facturer, the scope model, the serial number and the firmware 
revision level. 

*IDN? 

*IDN LECROY,<model>,<serial_number>,<firmware__level> 
<model> := 5-character model identifier 

<serial_number> := an 8-digit decimal code (94xxxxxx) 
<firmware_level> := 2 digits giving the release level followed by a 
period and a 1-digit update level (xx.y) 

This example issues an identification request to the scope. 

CMD$=” * IDN?” : CALL IBWRT(SCOPE%,CMD$) 

CALL IBRD(SCOPE%,RSP$): PRINT RSP$ 

Response message 

*IDN LECROY, 9450^,94501153, 02. 2 
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^ System Commands 



STATUS 

DESCRIPTION 



COMMAND SYNTAX 

QUERY SYNTAX 
Response format 

EXAMPLE (GPIB) 
RELATED COMMANDS 



INE 

Command/Query 



The INE command sets the Internal state change Enable register 
(INE) . This command allows one or more events in the INR regis- 
ter to be reflected in the INB summary message bit (bit 0) of the 
STB register. For an overview of the INR defined events refer to 
Table 7, page 99. 

The INE? query reads the contents of the INE register. 

Note: This command can be executed in both local and remote 
modes. 

INE <value> 

<value> := 0 to 65 535 

INE? 

INE <value> 

The following command allows the INB bit to be set whenever a 
screen dump has finished (bit 1, i.e. decimal 2) and/or a waveform 
has been acquired (bit 0, i.e. decimal 1). Summing these two val- 
ues yields the INE mask 2+1=3. 

CMD$="INE 3": CALL IBWRT(SCOPE%,CMD$) 

INR? 
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System Commands 



STATUS 



INR? 

Query 



DESCRIPTION 

QUERY SYNTAX 
Response format 



EXAMPLE (GPIB) 



The INR? query reads and clears the contents of the INternal state 
change Register (INR). The INR register (Table 7) keeps track of 
the completion of various internal operations and state transitions. 

INR? 

INR <state> 

<state> := 0 to 65535 

The following instruction reads the contents of the INR register. 
CMD$=”INR?” : CALL IBWRT(SCOPE%,CMD$) 

Response message: INR 1026 

i.e. waveform processing in Function E and a screen dump have 
both terminated. 



RELATED COMMANDS ALL_STATUS?, *CLS, INE 



Bit 


Bit Value 


Description 


15. ..12 




0 


Reserved for future use. 


11 


2048 


1 


Waveform processing has terminated in Function F. 


10 


1024 


1 


Waveform processing has terminated in Function E. 


9 


512 


1 


Waveform processing has terminated in Memory D$. 


8 


256 


1 


Waveform processing has terminated in Memory C$. 


7 


128 


1 


A memory card exchange has been detected.* 


6 


64 


1 


Memory card has become full in “Autostore Fill" mode.* 


5 


32 


1 


Autostore to memory card cannot begin. Check for 
errors in the Execution error Register.* 


4 


16 


1 


A segment of a sequence waveform has been acquired. 


3 


8 


1 


A time-out has occurred In a data block transfer. 


2 


4 


1 


A return to the local state is detected. 


1 


2 


1 


A screen dump has terminated. 


0 


1 


1 


A new signal has been acquired. 



Internal State Register Structure (INR) 
Table 7 



t 4-channel oscilloscopes only, reserved in the 2-channel oscilloscopes 
* only oscilloscopes equipped with the memory card option 
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System Commands 



WAVEFORM TRANSFER 



DESCRIPTION 



QUERY SYNTAX 



Response format 



t 4-channel oscilloscopes only 



INSPECT?, INSP? 

Query 



The INSPECT? query allows the user to read parts of an acquired 
waveform in intelligible form. The command is based on the expla- 
nation of the format of a waveform given by the template (use the 
query TEMPLATE? to obtain an up-to-date copy). Each logical 
block of a waveform may be inspected by giving its name (e.g. 
TRIGTIME as mentioned in the template) enclosed in quotes as 
the first (string) parameter. 

The special logical block named WAVEDESC may also be in- 
spected in more detail. By giving the name of a variable in the 
block WAVEDESC enclosed in quotes as the first (string) parame- 
ter, it is possible to inspect only the actual value of that variable. 



Notation 

BYTE: raw data as integers (truncated to 8 m.s.b.* ) 

WORD: raw data as integers (truncated to 16 m.s.b.* ) 

FLOAT: normalized data (gain, offset applied) as floating 

point numbers (gives measured values in volts or 
appropriate units) 

* most significant bits 



<trace>:INSPect? ’<string>’ [,<data_type>] 

<trace> := {EA, EB, MC, MD, FE, FF, Cl, C2, C3$, C4*} 

<string> := a valid name of a logical block or a valid name 
of a variable contained in block WAVEDESC 
(see the command TEMPLATE and Section 6). 

<data_type> := {BYTE, WORD, FLOAT} 

Note: The optional parameter <datajype> applies only for in- 
specting the data arrays. It selects the representation of the data. 
The default <data type> is FLOAT. 

<trace>:INSPect “<string>” 

<string> := a string giving name(s) and value (s) of a logical block 
or a variable. 
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System Commands ^ 



EXAMPLES (GPIB) 



RELATED COMMANDS 



1) The following command reads the value of the time base at 
which the last waveform in Channel 1 was acquired. 

CMD$:=“C1:INSP? ’TIMEBASE”’ 

CALL IB WRT (SCOPE%,CMD$) 

CALL IBRD(SCOPE%,RSP$): PRINT RSP$ 

Response message 

Cl-.INSP “TIMEBASE: 500 US/DIV” 

2) The following command reads the entire contents of the wave- 
form descriptor block. 

CMD$ = “C1:INSP? ’WAVEDESC’” 

TEMPLATE, WAVEFORM_SETUP 



101 



£ System Commands 



DISPLAY 



INTENSITY, INTS 

Command/Query 



DESCRIPTION 



COMMAND SYNTAX 



QUERY SYNTAX 
Response Format 

EXAMPLE (GPIB) 



The INTENSITY command sets the intensity level of the grid or 
the trace/text provided the local control of the intensity has been 
turned off. Note that normally the screen intensity is still under 
manual control when the oscilloscope operates remotely. The local 
intensity control has to be turned off (using the command INTS 
LOCAL, OFF) before the intensity levels can be modified re- 
motely. 

The intensity level is expressed as a percentage (PCT) . A level of 
100 PCT corresponds to the maximum intensity while a level of 0 
PCT sets the intensity to its minimum value. 

The response to the INTENSITY? query indicates the grid and 
trace intensity levels and their control mode. 

INTenSity LOCAL,<mode>,GRID,<value>,TRACE,<value> 

<mode> := {ON, OFF} 

<value> := 0 to 100 PCT 

Note 1: Parameters are grouped in pairs. The first one names the 
variable to be modified and the second one gives the new value to 
be assigned . Pairs may be given in any order and may be restricted 
to those variables to be changed. 

Note 2: The suffix PCT is optional. 

INTenSity? 

INTenSity LOCAL,<mode>, TRACE, <value>, GRID, <value> 

The following instruction enables remote control of the intensity 
and changes the grid intensity level to 75%. 

CMD$=”INTS LOCAL, OFF, GRID, 75” 

CALL IBWRT(SCOPE%,CMD$) 

The following instruction re-enables local control of the intensity. 

CMD$=INTS LOCAL, ON” 

CALL IBWRT(SCOPE%,CMD$) 
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System Commands £ 



ACQUISITION 

DESCRIPTION 



COMMAND SYNTAX 

QUERY SYNTAX 
Response Format 

EXAMPLE 

RELATED COMMANDS 
* 2 ns/div for Model 9430 



INTERLEAVED, ILVD 

Command/Query 



The INTERLEAVED command enables or disables random inter- 
leaved sampling (RIS). An environment error (see Table 6, page 
82) will be generated if the user attempts to turn off RIS when the 
time-base setting allows “ON” only, or to turn on RIS when the 
time-base setting allows “OFF” only (see table below). 



RIS 


9410/14 


9420/24/30 


9450 


“ON” 

only 


2 ns/div 
to 

20 ns/div 


1 ns/dlv* 
to 

20 ns/div 


1 ns/dlv 
to 

5 ns/dlv 


Selectable 

“ON”/“OFF” 


50 ns/div 
to 

5 jis/div 


50 ns/div 
to 

20 jjts/div 


10 ns/div 
to 

5 p,s/dlv 


“OFF" 

only 


10 p.s/div 
to 

1000 s/dlv 


50 p.s/dlv 
to 

5000 s/div 


10 |xs/div 
to 

5000 s/dlv 



RIS is not available for sequence mode acquisitions and therefore 
an attempt to turn it on in that mode will also result in an environ- 
ment error. 

The response to the INTERLEAVED? query indicates whether 
the oscilloscope is in the RIS mode. 

InterLeaVeD <mode> 

<mode> := {ON, OFF} 

InterLeaVeD? 

InterLeaVeD <mode> 

The following command sets the oscilloscope into RIS mode. 
CMD$ = ”ILVD ON”: CALL IBWRT(SCOPE%,CMD$) 

TIME_DIV, TRIG_MODE 
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System Commands 



STATUS 

DESCRIPTION 

QUERY SYNTAX 
Response format 

EXAMPLE (GPIB) 
RELATED COMMANDS 



*IST? 

Query 



The *IST? (Individual STatus) query reads the current state of the 
IEEE 488.1 defined “ist” local message. The “ist" individual 
status message is the status bit sent during a parallel poll operation. 

•1ST? 

•1ST <value> 

<value> := 0 or 1 

The following command reads the contents of the IST bit: 

CMDS = “•1ST?”: CALL IBWRT(SCOPE%,CMD$) 

CALL IBRD(SCOPE%,RSP$): PRINT RSP$ 

Response message 
•1ST 0 

•PRE 
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System Commands £ 



DISPLAY 



DESCRIPTION 



KEY 

Command 



The KEY command is used to display a string in the menu field 
next to one of the 9 menu buttons. The string may consist of up to 
12 characters and may be positioned at 4 different locations: 
above (LI), opposite (LC), or below (L2) the menu buttons; or 
(LB) between pairs of buttons, ([1,2], [3,4], [5,6] or [7,8]). See 
Figure 1 on next page. 

Note: The button names shown in Figure 1 are not the same as 
those indicated in the front-panel figure at the beginning of the 
Operator's Manual. 



r 
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Pause 

bu,,on 1 ° MEASUREMENT 

Continue 

button 2 O 










• 
























j 
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button 7 O 

button 8 O 


























button 9 O ^Exit 






EXAMPLE OF A MENU 
CREATED BY A REMOTE USER 

Figure 1 



Text assigned to the menu buttons will disappear on the next tran- 
sition to local but reappear when the instrument is switched back 
into the remote state. Text is cleared at power up, when the rear- 
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^ System Commands 



COMMAND SYNTAX 



EXAMPLE (GPIB) 



RELATED COMMANDS 



panel RESET button (64) is pressed or if an empty string is 
assigned to a location (e.g. KEY ” ”,L1). 

Pressing any one of the menu buttons while in remote mode causes 
the User Request status Register (URR) and the URQ bit of the 
Event Status Register to be set. This can generate an SRQ provided 
that the service request mechanism has been enabled. 

Note : This command can be executed in both iocal and remote 
modes. 

KEY <button>,’<string>*,<position> 

<button> := 1 to 9 

<string> := a 12 character string (any ASCII code) 

<position> := {LI, LC, L2, LB} 

Note: If the position is omitted , LC will be assumed. 

The example menu shown in Figure 1 was created by issuing the 
following series of KEY commands: 

KEY 1, * Pause’, LC; KEY 1, ’MEASUREMENT’, LB; KEY 2, 
’Continue’, LC; 

KEY 3, ’key 3 line l 1 , LI; KEY 3, ’key 3 line 2\L2; 

KEY 4, ’key 4 line 1\LI; KEY 4, ’key 4 line 2\L2; 

KEY 5, ’key 5 center’, LC; KEY 5, ’between 5/6’, LB; KEY 6, 
’key 6 center'.LC; 

KEY 9,’Exit’,LC 

URR? 
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System Commands £ 



DISPLAY 



MESSAGE, MSG 

Command/Query 



DESCRIPTION 



COMMAND SYNTAX 



QUERY SYNTAX 
Response Format 

EXAMPLE (GPIB) 



The MESSAGE command displays a string of characters in the 
Message Field above the grid. The string may be up to 45 charac- 
ters in length. The string is displayed as long as the instrument is in 
remote mode and no internal status message is generated. Turning 
the oscilloscope back to local mode deletes the message. After the 
next transition from local to remote the message will be 
redisplayed. The message is cleared at power up when the RESET 
button on the rear panel is pressed or if an empty string is sent 
(MSG ” ”)• 

The MESSAGE? query allows the user to read the last message 
which was sent. 

Note: This command can be executed in both local and remote 
modes. 

MeSsaGe ’<string>’ 

<string> := a string of max. 45 characters 

MeSsaGe? 

MeSsaGe ”<string>” 

The following code causes the message ”* Connect Probe 1*” to 
appear in the message field. 

CMD$=”MSG ’’Connect Probe 1*”’ 

CALL IBWRT(SCOPE%,CMD$) 
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^ System Commands 



DISPLAY 

DESCRIPTION 

COMMAND SYNTAX 

QUERY SYNTAX 
Response format 

EXAMPLE (GPIB) 
RELATED COMMANDS 



MULTI_ZOOM, MZOM 

Command/Query 



By setting MULTI_ZOOM ON, the horizontal magnification and 
positioning controls apply to all expanded traces simultaneously. 
This command is useful if the contents of all expanded traces are 
to be examined at the same time. 

The MULTI_ZOOM? query indicates whether multiple zoom is 
enabled or not. 

Note: This command has the same effect as DUALJZOOM. 

Multi_ZOoM <mode> 

<mode> := {ON, OFF} 

Multi_ZOoM? 

Multi_ZOoM <mode> 

The following example turns the multiple zoom on. 
CMD$=”MZOM ON”: CALL IBWRT(SCOPE%,CMD$) 

HOR_MAGNIFY, HOR_POSITION, DUAL_ZOOM, ZOOM 
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System Commands ^ 



ACQUISITION 

DESCRIPTION 



OFFSET, OFST 

Command/Query 



The OFFSET command allows the vertical offset of the specified 
input channel to be adjusted. 

The maximum ranges depend on the fixed sensitivity setting as 
follows: 



9410/14/30 


Fixed Sensitivity 


Offset Range 


Voltage 


2 V 

1 V to 10 mV 
5 mV 

2 mV 
1 mV 


dh 6 times 
± 12 times 
± 24 times 
± 60 times 
dh 120 times 


± 12 V 

± 12V to ± 120 mV 
± 120 mV 
± 1 20 mV 
± 120 mV 



All Others 


Fixed Sensitivity 


Offset Range 


Voltage 


1 V 

0.5 V to 20 mV 
10 mV 
5 mV 


± 10 times 
± 12 times 
± 24 times 
± 48 times 


± 10V 

± 6 V to ± 240 mV 
± 240 mV 
± 240 mV 



If an out-of-range value is entered, the oscilloscope is set to the 
closest possible value and the VAB bit (bit 2) in the STB register is 
set. 

Note : The probe attenuation factor is not taken into account for 
adjusting the offset. 

The OFFSET? query returns the DC offset value of the specified 
channel. 
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^ System Commands 



COMMAND SYNTAX 



QUERY SYNTAX 
Response format 

EXAMPLE (GPIB) 



<channeI>:OFfSeT <offset> 

<channel> := {Cl, C2, C3t, C4t} 

<offset> := -12V to 12V (maximum range) 

Note: The suffix V is optional . 

<channel>:OFfSeT? 

<channel>:OFfSeT <offset> 

The following command sets the offset of Channel 2 to -3 V. 
CMD$=”C2:OFST -3V”: CALL IBWRT(SCOPE%,CMD$) 



i 4-channel oscilloscopes only 



110 



STATUS 

DESCRIPTION 



COMMAND SYNTAX 

QUERY SYNTAX 
Response format 

RELATED COMMANDS 



System Commands 



5 



*OPC 

Command/Query 



The *OPC (Operation Complete) command sets the OPC bit (bit 
0) in the standard Event Status Register (ESR) to true. This com- 
mand has no other effect on the operation of the oscilloscope as 
the instrument starts parsing a command or query only after it has 
completely processed the previous command or query. 

The *OPC? query always responds with the ASCII character “1” 
as the oscilloscope responds to the query only once the previous 
command has been entirely executed. 

Note: This command can be executed in both local and remote 
modes. 

♦OPC 



*OPC? 
♦OPC 1 

* WAI 
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^ System Commands 



MISCELLANEOUS 

DESCRIPTION 

QUERY SYNTAX 
Response format 

EXAMPLE (GPIB) 



♦OPT? 

Query 

The *OPT? query identifies oscilloscope options, i.e. additional 
firmware or hardware options. The response consists of a series of 
response fields listing all the installed options. 

♦ OPT? 

*OPT <option_l>,<option_2>,..,<option__N> 

<optionJ> := character data 

Note: If no option is present, the character 0 will be returned. 

This example queries the installed options. 

CMD$=” ♦OPT?” : CALL IBWRT(SCOPE%,CMD$) 

CALL IBRD(SCOPE%,RSP$): PRINT RSPS 
Response message 
♦OPT 0 

If the waveform processing options WP01 and WP02 are installed, 
the response message is 

♦OPT WP01.WP02 
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System Commands 



SAVE/RECALL SETUP 

DESCRIPTION 



COMMAND SYNTAX 

QUERY SYNTAX 
Response syntax 

EXAMPLE (GPIB) 



RELATED COMMANDS 



PANELJSETUP, PNSU 

Command/Query 



The PANEL_SETUP command complements the *SAV/*RST 
commands. The PANEL_SETUP command allows panel setups to 
be archived in encoded form on external storage media. 

Only setup data read by the PNSU? query may be recalled into the 
oscilloscope. A panel setup error (see Table 6, page 84) will be 
generated if the setup data block contains invalid data. 

Note: The communication parameters (those modified by com- 
mands CFMT, CHDR, CHIP, CORD and WFSU) and the enable 
registers associated with the status reporting system (SRE, PRE, 
ESE, INE) are not saved by this command. 

PaNel_SetUp <setup> 

<setup> := A setup block previously read by PNSU? 

PaNel_SetUp? 

PaNel_SetUp <setup> 

1. The following instruction saves the instrument’s current panel 
setup in the file PANEL. SET. 

FILES = “PANEL. SET”: CMD$ = “PNSU?” 

CALL IBWRT(SCOPE%,CMD$) 

CALL IBRDF(SCOPE%, FILES) 

2. The following command recalls the front-panel setup stored 
previously in the file PANEL. SET into the oscilloscope. 

CALL IBWRTF(SCOPE%, FILES) 

*RCL, *SAV 
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^ System Commands 



CURSOR 



DESCRIPTION 



PARAMETERJVALUE?, PAVA? 

Query 



The PARAMETER_VALUE? query returns the current value (s) 
of the pulse waveform parameter(s) for the specified trace. Traces 
do not need to be displayed or selected to obtain the values meas- 
ured by the pulse parameters. 

Pulse parameters cannot be evaluated on waveforms composed of 
segments acquired in sequence mode. However pulse parameters 
may be applied to individual segments if they are singled out using 
the expansion function. 



Parameter Names 



ALL 


all parameters 


ALLI 


all points in 
(TRUE=1, FALSE=0) 


AMPLI 


amplitude 


ANYO 


any points 
(TRUE=1 , FALSE=0) 


AREA 


area 


BASE 


base 


CVCL 


cycles 


DLY 


delay 


DUTY 


duty cycle 


FALL 


falltime 


FREQ 


frequency 


FRST 


first point 


LAST 


last point 


MAX 


maximum 


MEAN 


mean 


MIN 


minimum 


OVSN 


negative overshoot 


OVSP 


positive overshoot 


PER 


period 


PNTS 


points 


PKPK 


peak-to-peak 


RISE 


risetime 


RMS 


root mean square 


SDEV 


standard deviation 


TOP 


top 


WID 


width 



See Table 4 in Chapter 7 of Operator's Manual 



Parameter Computation States 

OK deemed to be determined without problem 
AV averaged over several (up to 100) periods 
PT window has been period truncated 
IV invalid value (insufficient data provided) 

NP no pulse waveform 

LT less than given value 

OF signal partially in overflow 

UF signal partially in underflow 

OU signal partially in overflow and underflow 

See Figure 15 in Chapter 5 of Operator’s Manual 
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System Commands 



QUERY SYNTAX 



Response Format 



EXAMPLE (GPIB) 



RELATED COMMANDS 



$ 4-channel oscilloscopes only 



<trace>:PArameter_VAlue? [<parameter>, ... <parameter>] 

<trace> := {EA, EB, MC, MD, FE, FF, Cl, C2, C3$, C4*} 
<parameter> := {FRST, LAST, PNTS, MIN, MAX, MEAN, 
SDEV, RMS, DLY, PER, WID, RISE, FALL, ALL} 



<trace>: PArameter_VAlue <parameter>,<value>,<state> [ , . . . 
,<parameter>,<value>,<state>] 

<value> := decimal numeric value 

<state> := {OK, AV, PT, IV, NP, LT, OF, UF, OU} 

Note: If <parameter> is not specified, or equal to ALL, all the 
parameters followed by their values and states are returned. 

The following query reads the risetime of Expand B (EB). 
CMD$=”EB:PAVA? RISE”: CALL IBWRT(SCOPE%,CMD$) 
CALL IBRD (SCOPE%,RD$): PRINT RD$ 

Response message 
EB:PAVA RISE.3.6E-9S.OK 

CURSOR_MEASURE, CURSOR_SET, 
PASS_FAIL_COUNTER, PASS_FAIL_DO, 

PASS FAIL MASK 
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^ System Commands 



MISCELLANEOUS 

DESCRIPTION 



COMMAND SYNTAX 



QUERY SYNTAX 
Response format 

EXAMPLE (GPIB) 
RELATED COMMANDS 



PASS_FAIL_CONDITION, PFCO 

Command/Query 



The PASS_FAIL_CONDITION command adds a Pass/Fail test 
condition or an extended parameter at a specified position. 

The PAS S_F AI L_CONDITION? query indicates the current 
Pass/Fail test setup or the current selection of extended parame- 
ters at a specified position. 

Note: Up to four test conditions (or extended parameters) can be 
specified at four different positions on the screen. The 
PASS_FAIL_CONDITION command deals with one position at a 

time. 



Notation 






GT Greater than 


LT 


Lower than 



Pass_Fail_COndition [<pos>,<trace>,<param>[,<rel_op>[, 
<ref_value>] ] ] 

<pos> := {1,2,3, 4} 

<trace> := {EA, EB, MC, MD, FE, FF, Cl, C2, C3, C4} 
<eparam> := extended parameters; (see list on next page) 
<rel_op> := {GT.LT} 

<ref_value> := 0.001e-33 to 999.999e33 

Note: The PFCO command with no arguments (i.e. "PFCO") de- 
letes all conditions. 

PFCO? <pos> 

PFCO <pos> [ ,<trace>, <param> [ ,<rel_op> [ , 

<ref_value>]]] 

The following command sets the first test condition in the list to be: 
“frequency on Channel 1 lower than 10 kHz”. 

CMD$ = “PFCO 1, Cl, FREQ, LT, 10000”: 

CALL IB WRT (SCOPE%,CMD$) 

CURSOR_MEASURE, CURSOR_SET, 
PASS_FAIL_COUNTER, PASS_FAIL_DO, 
PASS_FAIL_MASK, PARAMETER VALUE 
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System Commands 



MISCELLANEOUS 

DESCRIPTION 

COMMAND SYNTAX 
QUERY SYNTAX 
Response Format 

RELATED COMMANDS 



PASS_FAIL_COUNTER, PFCT 

Command/Query 



The PASS_FAIL_COUNTER command resets the Passed/Failed 
acquisitions counter. The PASS_FAIL_COUNTER? query re- 
turns the current count. 

Pass_Fail_CounTer 

Pass_Fail_CounTer? 

Pass_Fail_CounTer <pass_fail>,<value>,OF,<value> 

<pass_fail> := {PASS, FAIL} 

<value> := 0 to 999999 

CURSOR_MEASURE, CURSOR_SET, PASS_FAIL_DO, 

PASS FAIL_MASK, P AR AM ETE REVALUE 
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System Commands 



MISCELLANEOUS 

DESCRIPTION 



COMMMAND SYNTAX 

QUERY SYNTAX 
Response Format 
EXAMPLE (GPIB) 

RELATED COMMANDS 



PASS_FAIL_DO , PFDO 

Command/Query 



The PASS_FAIL_DO command defines the actions that have to 
be performed by the oscilloscope after a Pass/Fail test. The 
PASS_FAIL_DO? query indicates which actions are currently se- 
lected. 



Notation 

STOP 


Stop acquisition 


SCDP 


Make a hardcopy 


STO 


Store in Memory 


PULS 


Send a pulse from the rear-panel accessory 


BEEP 


Emit a loud “beep” 


STCD 


Store to Memory Card 



Pass_Fail_DO [<pass_fail>[,<act>[,<act>...]]] 

<pass_fail> := {PASS, FAIL} <act> := {STOP, SCDP, STO, PULS, 
BEEP, STCD} 

Note: The PFDO command with no arguments (i.e. "PFDO") deletes all 
actions. 

Pass Fail DO? 



Pass_Fail_DO [<pass_fail>[,<act>[,<act>...] ]] 



The following command forces the oscilloscope to “beep” and 
stop acquiring, when the test passes. 

CMD$=” Pass_Fail_DO PASS, BEEP, STOP” : 

CALL IBWRT(SCOPE%,CMD$) 

PASS_FAIL_COUNTER, PASS_FAIL_MASK, 
PARAMETER_VALUE?, CURSOR_MEASURE, 

CURSOR SET 
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System Commands £ 



MISCELLANEOUS 

DESCRIPTION 
COMMAND SYNTAX 

QUERY SYNTAX 
Response Format 

EXAMPLE (GPIB) 
RELATED COMMANDS 



PASS_FAIL_MASK, PFMS 

Command/Query 



The PASS_FAIL_MASK command generates a tolerance mask 
around a selected waveform and stores the result in Memory C. 
The PASS_FAIL_MASK? query returns the current tolerance 
values. 

<trace>:Pass_Fail_MaSk <htol_minus>,<htol_plus>, 
<vtol_minus>,<vtol_plus>,<htol_minus>,<htol_plus>, 
<vtol_minus>,<vtol_plus>: float numbers 

Note: if any arguments are missing, the previous settings will be 
used. 

Pass_Fail_MaSk? 

Pass_Fail_MaSk <htol_minus>,<htol_plus>,<vtol_minus>, 
<vtol_plus> 

The following command generates a tolerance mask around the 
Channel 1 trace. The tolerance is set at 1.5 V over the trace and 
0.7 V under, 25 nanoseconds before the trace and 12 after. 

CMD$ = “Cl: PASS_FAIL_MASK 25 NS, 12 NS, 0.7 V, 

1.5 V” :CALL IBWRT(SCOPE%,CMD$) 

CURSOR_MEASURE, CURSOR_SET, 
PASS_FAIL_COUNTER, PASS_FAIL_DO, 

PARAMETER VALUE 
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DISPLAY 

DESCRIPTION 
COMMAND SYNTAX 

QUERY SYNTAX 
Response format 

EXAMPLE (GPIB) 
RELATED COMMANDS 



PERSIST, PERS 

Command/Query 

The PERSIST command enables or disables the persistence dis- 
play mode. 

PERSist <mode> 

<mode> := {ON, OFF} 

PERSist? 

PERSist <mode> 

The following code turns the persistence display ON. 
CMD$=”PERS ON": CALL IBWRT(SCOPE%,CMD$) 

PERSIST_SETUP, XY_DISPLAY 
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CURSOR 



DESCRIPTION 



COMMAND SYNTAX 



QUERY SYNTAX 



Response Format 



PER_CURSOR_SET, PECS 

Command/Query 



The PER_CURSOR_SET command allows the user to position any 
one of the six independent cursors at a given screen location. The 
position of the cursor can be modified or queried even if the cursor 
is not currently displayed on the screen. 

The PER_CURSOR_SET? query indicates the current position of 
the cursor (s). 



Notation 






HABS 


Horizontal absolute 


VABS 


Vertical absolute 


HREF 


Horizontal reference 


VREF 


Vertical reference 


HDIF 


Horizontal difference 


VDIF 


Vertical difference 



PEr_Cursor_Set <cursor>,<position>[,<cursor>,<position>,..., 
<cursor>,<position> 

<cursor> := {HABS, VABS, HREF, HDIF, VREF, VDIF} 

<position> := 0 to 10 DIV (horizontal) 

-4 to 4 DIV (vertical) 

Note 1: The suffix DIV is optional . 

Note 2: Parameters are grouped in pairs. The first one names the 
variable to be modified and the second one gives the new value to 
be assigned. Pairs may be in any order and may be restricted to 
those variables to be changed. 

PEr_Cursor_Set? <cursor> [<cursor, . . . ,<cursor>] 

<cursor> := {HABS, VABS, HREF, HDIF, VREF, VDIF, 

ALL} 

Note: If <cursor> is not specified , ALL will be assumed. If the 
position of a cursor cannot be determined in a particular situa- 
tion, its position will be indicated as UNDEF. 

PEr_Cursor_Set <cursor>,<position> [,<cursor>,<position>, . . . , 
<cursor>,<position> 
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EXAMPLE (GPIB) 



RELATED COMMANDS 



The following code positions the HREF and HDIF cursors at +2.6 
DIV and +7.4 DIV respectively, using Memory C as a reference. 

CMD$=”MC:PECS HREF.2.6 DIV,HDIF,7.4DIV” 
CURSOR_MEASURE, PERSIST, PER_CURSOR_VALUE 
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CURSOR 

DESCRIPTION 

QUERY SYNTAX 

Response format 
EXAMPLE (GPIB) 

RELATED COMMANDS 



t 4-channel oscilloscopes only 



PER_CURSOR_VALUE?, PECV? 

Query 



The PER_CURSOR_VALUE? query returns the values measured 
by the specified cursors for a given trace. 



Notation 






HABS 


Horizontal absolute 


HREL 


Horizontal relative 


VABS 


Vertical absolute 


VREL 


Vertical relative 



<trace>:PEr_Cursor_Value? <cursor>[,<cursor>,...,<cursor>] 

<trace> := {EA, EB, MC, MD, FE, FF, Cl, C2, C3$, C4*} 
<cursor> := {HABS, VABS, HREL, VREL, ALL} 

Note: If <cursor> is not specified, ALL will be assumed . 



<trace>:PEr_Cursor_Value <cursor>,<value>[,<cursor>, 

<value>, . . . ,<cursor>,<value>] 

The following code returns the value measured with the vertical 
relative cursor on Channel 1. 

CMD$=”C1 :PECV? VREL”: CALL IBWRT(SCOPE%,CMD$) 
CALL IBRD(SCOPE%,RSP$): PRINT RSP$ 

Response message 
C1:PECV VREL, 56 MV 

CURSOR_MEASURE, PERSIST, PER_CURSOR_SET 
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£ System Commands 



COMMUNICATION 

DESCRIPTION 

COMMAND SYNTAX 

QUERY SYNTAX 
Response format 

EXAMPLE (GPIB) 
RELATED COMMANDS 



PERSIST_SETUP, PESU 

Command/Query 



The PERSIST_SETUP command sets the number of sweeps to be 
retained in the persistence display. 

The PERSIST_SETUP? query reports the number of sweeps that 
will currently be retained in the persistence display. 

PErsist_SetUp <sweeps> 

<sweeps> := {1, 2, 5, 10, 20, 50, 100, 200, INF} 

PErsist_SetUp? 

PErsist_SetUp <sweeps> 

The following code sets the number of sweeps contributing to the 
persistence display to 50: 

CMD$=”PESU 50”: CALL IBWRT(SCOPE%,CMD$) 

PERSIST 
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STATUS 

DESCRIPTION 



COMMAND SYNTAX 

QUERY SYNTAX 
Response format 

EXAMPLE (GPIB) 
RELATED COMMANDS 



*PRE 

Command/Query 



The *PRE command sets the PaRallel poll Enable register (PRE). 
The lowest 8 bits of the Parallel Poll Register (PPR) are composed 
of the STB bits. The *PRE command allows the user to specify 
which bit(s) of the parallel poll register will affect the ’ist’ individ- 
ual status bit. 

The *PRE? query reads the contents of the PRE register. The re- 
sponse is a decimal number which corresponds to the binary sum 
of the register bits. 

Note: This command can be executed in both local and remote 
modes. 

PRE <value> 

<value> := 0 to 65 535 

*PRE? 

*PRE <value> 

The following command will cause the ’ist’ status bit to become 1 
as soon as the MAV bit (bit 4 of STB, i.e. decimal 16) is set. This 
yields the PRE value 16. 

CMD$=” *PRE 16”: CALL IBWRT(SCOPE%,CMD$) 

•1ST? 
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SAVE/RECALL SETUP 

DESCRIPTION 

COMMAND SYNTAX 
EXAMPLE (GPIB) 

RELATED COMMANDS 



*RCL 

Command 



The *RCL command sets the state of the instrument using one of 
the eight non-volatile panel setups by recalling the complete 
front-panel setup of the instrument. Panel setup 0 corresponds to 
the default panel setup. 

The *RCL command produces the opposite effect of the *SAV 
command. 

If the desired panel setup is not acceptable, the Execution error 
status Register (EXR) is set and the EXE bit of the standard Event 
Status Register (ESR) is set. 

*RCL <panel_setup> 

<panel_setup> := 0 to 7 

The following code recalls the instrument setup previously stored 
in panel setup 5 

CMD$=” *RCL 5”: CALL IBWRT(SCOPE%,CMD$) 
PANEL_SETUP, *SAV, EXR? 
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SAVE/RECALL SETUP 

DESCRIPTION 
COMMAND SYNTAX 

EXAMPLE (GPIB) 
RELATED COMMANDS 



RECALL_PANEL, RCPN 

Command 

Oscilloscopes fitted with the MC01 Option 

The RECALL_PANEL command recalls a front-panel setup from 
the memory card. 

ReCall_PaNel FILE,’<fiIename>’ 

<filename> := a string of up to 8 characters. Any extension will be 
ignored. Front-panel setup files are always stored 
with the extension ”.PNL” on the card. 

The following command recalls the front-panel setup from file 
P012.PNL 

CMD$=”RCPN FILE/P012’” :CALL IBWRT(SCOPE%,CMD$) 
PANEL_SETUP, *SAV, STORE_PANEL, *RCL 
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^ i System Commands 



WAVEFORM TRANSFER 



DESCRIPTION 



COMMAND SYNTAX 



EXAMPLE (GPIB) 



RELATED COMMANDS 



$ 4-channel oscilloscopes only 



RECALL, REC 

Command 

Oscilloscopes fitted with the MC01 Option 

The RECALL command recalls a waveform file from the memory 
card into one of the internal memories Memory C, Memory D, 
Function Et, or Function Ft. 

<memory>:RECall FILE,<mode> 

<memory> := {MC, MD, FEt, FFt} 

<mode> := {SAME, PREVIOUS, NEXT, NEWEST, OLDEST, 
‘<filename>’} 

<filename> := an alphanumeric string of up to 8 characters, fol- 
lowed by a dot and an extension of up to 3 digits. 

The following commands first recall a waveform file called 
’’SC1.001” into Memory C, after which the NEXT waveform file 
in the card directory list is recalled to Memory D. 

CMD$=”MC:REC FILE, ’SCI. 001’;MD:REC NEXT": 

CALL IBWRT(SCOPE%,CMD$) 

FUNCTION_STATEt, STORE, INR? 



128 



System Commands ^ 



SAVE/RECALL SETUP 

DESCRIPTION 

COMMAND SYNTAX 
EXAMPLE (GPIB) 

RELATED COMMANDS 



*RST 

Command 



The *RST command initiates a device reset. The *RST sets all 8 
traces to the GND line, recalls the default setup and causes a cali- 
bration to be performed. 

*RST 

This example resets the oscilloscope 

CMD$=” *RST”: CALL IBWRT(SCOPE%,CMD$) 

*CAL?, *RCL 
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ACQUISITION 

DESCRIPTION 
COMMAND SYNTAX 



QUERY SYNTAX 
Response Format 

EXAMPLE 



t nol available on 941X 



SAMPLE_CLOCK, SCLK* 

Command/Query 



The SAMPLE_CLOCK command allows the user to control the 
use of an external time base. The user sets the number of data 
points that will be acquired when the oscilloscope is using the ex- 
ternal clock. 

Sample_CLocK <state> [ ,<recordlength>] 

<state> := {INT.EXT} <recordlength> := {50, 100, 200, 500, 

1000, 2000, 5000, 

10000, 20000, 

50000} 

Note: If <recordlength> is not specified the previous value will not 
be modified. (The parameter <recordlength> is initially set to 
50000 ). 

Sample_CLocK? 

Sample_CLocK <state>,<recordlength> 

The following command sets the oscilloscope to use the external 
clock with 1000 data point records. 

CMD$ = “SCLK EXT, 1000”: CALL IBWRT(SCOPE%,CMD$) 
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SAVE/RECALL SETUP 
DESCRIPTION 

COMMAND SYNTAX 
EXAMPLE (GPIB) 

RELATED COMMANDS 



*SAV 



Command 



The *SAV command stores the current state of the instrument in 
non-volatile internal memory. The *SAV command stores the 
complete front-panel setup of the instrument at the time the com- 
mand is issued. 

Note: The communication parameters (those modified by com- 
mands C OMM _FORMA T, COMM_HEADER, COMMJiELP, 
COMMjORDER and WAVEFORM JSETUP) and the enable reg- 
isters associated with the status reporting system (*SRE, *PRE, 
*ESE, INE) are not saved by this command. 

*SAV <panel_setup> 

<panel_setup> := 1 to 7 

The following code saves the current instrument setup in panel 
setup 5. 

CMD$=” *SAV 5”: CALL IBWRT(SCOPE%,CMD$) 
PANEL_SETUP, *RCL 
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^ System Commands 



HARD COPY 

DESCRIPTION 



COMMAND SYNTAX 

QUERY SYNTAX 
Response format 

EXAMPLE (GPIB) 
RELATED COMMANDS 



SCREEN_DUMP, SCDP 

Command/Query 



The SCREEN_DUMP causes the oscilloscope to dump the screen 
contents onto the hard copy device. For plotting, this command 
will not halt oscilloscope activities since plotting is performed in 
parallel with other tasks, unless it is done over the same port as the 
remote control. Printing, however, cannot be done in parallel with 
other oscilloscope operations. 

Screen dumps may be aborted by adding [A] to the screen dump 
command, as shown in the command syntax below. 

The time/date stamp which appears on the plot corresponds to the 
time at which the command was executed. 

The SCREEN_DUMP? query indicates whether a screen dump is 
currently in progress (ON) or has finished (OFF). 

SCreen_DumP [A] 

Note: The optional parameter “A " may be used to abort a screen 
dump. 

SCreen_DumP? 

SCreen_DumP <status> 

<status> := {ON, OFF} 

The following code initiates a screen dump. 

CMD$=”SCDP”; CALL IBWRT(SCOPE%,CMD$) 

INR?, HARDCOPY_SETUP, HARDCOPY_TRANSMIT 
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ACQUISITION 

DESCRIPTION 

COMMAND SYNTAX 

QUERY SYNTAX 
Response Format 

EXAMPLE 

RELATED COMMANDS 



SEGMENTS, SEGS 

Command/Query 



The SEGMENTS command sets the number of segments for se- 
quence mode acquisition. 

The response to the SEGMENTS? query indicates the number of 
segments which is set in the oscilloscope. 



SEGmentS <segments> 



<segments> := 



9410/14 


All others 


{2,5,10,20,50} 


{2,5,10,20,50,100,200} 



SEGmentS? 

SEGmentS <segments> 

The following command sets the segment count to 100. 
CMD$ = ”SEGS 100”: CALL IBWRT(SCOPE%,CMD$) 

TRIG MODE 
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DISPLAY 

DESCRIPTION 

COMMAND SYNTAX 

QUERY SYNTAX 
Response format 

EXAMPLE (GPIB) 

RELATED COMMANDS 



SELECT, SEL 

Command/Query 

The SELECT command selects the specified trace for manual dis- 
play control. An environment error (Table 6, page 84) is 
generated if the specified trace is not displayed. 

The SELECT? query returns the selection status of the specified 
trace. 

<trace>:SELect 

<trace> := {EA, EB, MC, MD, FE, FF} 

<trace>:SELect? 

<trace>:SELect <mode> 

<mode> := {ON, OFF} 

The following command selects Expand B (EB). 
CMD$=”EB:SEL” : CALL IBWRT(SCOPE%,CMD$) 

TRACE 
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STATUS 



*SRE 

Command/Query 



DESCRIPTION 



COMMAND SYNTAX 

QUERY SYNTAX 
Response format 

EXAMPLE (GPIB) 



The *SRE command sets the Service Request Enable register 
(SRE) . This command allows the user to specify which summary 
message bit(s) in the STB register will generate a service request. 
Refer to Table 8, page 137 for an overview of the available sum- 
mary messages, 

A summary message bit is enabled by writing a 1 into the corre- 
sponding bit location. Conversely, writing a 0 into a given bit 
location prevents the associated event from generating a service 
request (SRQ) . Clearing the SRE register disables SRQ interrupts. 

The *SRE? query returns a value which when converted to a bi- 
nary number represents the bit settings of the SRE register. Note 
that bit 6 (MSS) cannot be set and its returned value is always 
zero. 

Note: This command can be executed in both local and remote 
modes. 

*SRE <value> 

<value> := 0 to 255 

♦SRE? 

*SRE <value> 

The following command allows an SRQ to be generated as soon as 
the MAV summary bit (bit 4, i.e. decimal 16) and/or the INB 
summary bit (bit 0, i.e. decimal 1) in the STB register are set. 
Summing these two values yields the SRE mask 16 + 1 = 17. 

CMD$=” *SRE 17”: CALL IBWRT(SCOPE%,CMD$) 
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STATUS 

DESCRIPTION 

QUERY SYNTAX 
Response format 

EXAMPLE (GPIB) 
RELATED COMMANDS 



*STB? 

Query 



The ’STB? query reads the contents of the 488.1 defined status 
register (STB), and the Master Summary Status (MSS). The re- 
sponse represents the values of bits 0 to 5 and 7 of the Status Byte 
register and the MSS summary message. 

The response to a *STB? query is identical to the response of a 
serial poll except that the MSS summary message appears in bit 6 
in place of the RQS message. Refer to Table 8, page 137 for further 
details on the status register structure. 

•STB? 

•STB <value> 

<value> := 0 to 255 

The following instruction reads the status byte register. 

CMD$=”*STB?”: CALL IBWRT(SCOPE%,CMD$) 

CALL IBRD(SCOPE%,RSP$): PRINT RSP$ 

Response message 
•STB 0 

ALL STATUS?, *CLS, *PRE, ‘SRE 
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Bit 


Value 


Name 


Description 


Note 


7 


128 


DI07 


0 Reserved for future use 




6 


64 


MSS/RQS 
MSS =1 
RQS =1 


at least 1 bit in STB masked by SRE is 1 
service is requested 


Bl 


5 


32 


ESB 


1 an ESR enabled event has occurred 


(3) 


4 


16 


MAV 


1 Output queue is not empty 


(4) 


3 


8 


DI03 


0 Reserved 




2 


4 


VAB 


1 a command data value has been adapted 


(5) 


1 


2 


DIOI 


0 Reserved 




0 


1 


INB 


1 an enabled INternal state change 
has occurred. 


(6) 



Status Byte Register (STB) 

Table 8 



Notes: 

(1 ) The Master Summary Status (MSS) indicates that the instrument requests service while the Service Request 
status - when set - specifies that the oscilloscope Issued a service request. Bit position 6 depends on the 
polling method: 

Bit 6 = MSS If a *STB? query is received 
= RQS If serial polling Is conducted 

(2) Example: if SRE = 10 and STB = 10 then MSS = 1 . if SRE = 010 and STB = 100 then MSS=0. 

(3) The Event Status Bit (ESB) indicates whether or not one or more of the enabled IEEE 488.2 events have 
occurred since the last reading or clearing of the Standard Event Status Register (ESR). ESB is set If an 
enabled event becomes true ( 1 ) . 

(4) The Message Available bit (MAV) indicates whether or not the Output queue is empty. The MAV summary bit 
is set true (1) whenever a data byte resides in the Output queue. 

(5) The Value Adapted Bit (VAB) is set true (1 ) whenever a data value in a command has been adapted to the 
nearest legal value. For Instance, the VAB bit would be set if the time base is redefined as 2.5 jisec/div since 
the adapted value Is 2 jisec/div. 

(6) The INternal state Bit (INB) is set true (1) whenever certain enabled internal states are entered. For further 
information, refer to the INR? query. 
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System Commands 



ACQUISITION 

DESCRIPTION 

COMMAND SYNTAX 
EXAMPLE 

RELATED COMMANDS 



STOP 

Command 



The STOP command immediately stops the acquisition of a signal. 
It changes the acquisition state from “ready" to “triggered”, and if 
the trigger mode is AUTO or NORM it will change to trigger mode 
SINGLE to prevent further acquisition. 

STOP 

The following command stops the acquisition process. 

CMD$ = "STOP”: CALL IBWRT(SCOPE%,CMD$) 

ARM_ACQUISITION, TRIG_MODE, WAIT 
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System Commands 



WAVEFORM TRANSFER 



DESCRIPTION 



COMMAND SYNTAX 



EXAMPLE (GPIB) 



RELATED COMMANDS 



t 4-channel oscilloscopes only 



STORE, STO 

Command 



The STORE command stores the contents of the specified trace 
into one of the internal function memories Memory C, 
Memory D, Function E$, Function F$, or to the memory card.* 

<memory>: STOre <trace> [ , ’<filename>’ ] * 

<memory> := {MC, MD, FEJ, FF$, CARD*} 

<trace> := {EA, EB, MC, MD, FE, FF, Cl, C2, C3*, C4*} 
<filename> := a string of up to 8 characters. 

Notes applying to oscilloscopes equipped with the memory card 
option: 

1. Any extension supplied with the filename is ignored . 

2. If no filename (or an empty string) is supplied, the oscilloscope 
generates a filename according to its internal rules . 

3 . If the CARD:STORE command is sent without any argument , 
all traces currently enabled in the Store Setup will be stored on 
the card. This setup can be modified using the STORE_SETUP 
command . 

The following command stores the contents of Expand B (EB) into 
Memory D (MD). 

CMD$=”MD:STO EB”: CALL IBWRT(SCOPE%,CMD$) 

The following command stores Cl on the memory card in a file 
called ’’DIODE”.* 

CMD$=” CARD: STO Cl, ’DIODE’”: 

CALL IBWRT(SCOPE%,CMD$) 

FUNCTION_STATE$, STORE_SETUP*, RECALL 



* only oscilloscopes equipped with the memory card option 
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£ System Commands 



SAVE/RECALL PANEL 



DESCRIPTION 



COMMAND SYNTAX 



EXAMPLE (GPIB) 



RELATED COMMANDS 



STORE_PANEL, STPN 

Command 

Oscilloscopes fitted with the MC01 Option 

The STORE_PANEL command stores the complete front-panel 
setup of the instrument, at the time the command is issued, into a 
file on the memory card. 

Note: The communication parameters ( those modified by com- 
mands COMMJFORMAT, COMM_HEADER, COMMJHELP, 
COMMjORDER and WAVEFORM _SETUP) and the enable reg- 
isters associated with the status reporting system (*SRE, *PRE, 
*ESE, INE) are not saved by this command. 

STore_PaNel FILE,’<filename>’ 

<filename> := a string of up to 8 characters. Any extension will be 
ignored. Front-panel setup files are always stored 
with the extension ”.PNL” on the card. 

Note: If no filename (or an empty string) is supplied, the oscillo- 
scope generates a filename according to its internal rules. 

The following code saves the current instrument setup to the 
memory card in a file called ’’DIODE. PNL”: 

CMD$=”STPN FILE, ’DIODE’”: 

CALL IB WRT (SCOPE%,CMD$) 

PNSU, *SAV, RECALL_PANEL, *RCL 
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System Commands J 



WAVEFORM TRANSFER 
DESCRIPTION 



COMMAND SYNTAX 



jQUERY SYNTAX 
Response format 

$ 4-channel oscilloscopes only 



STOREJSETUP, STST 

Command/Query 
Oscilloscopes fitted with the MC01 Option 

The STOREJSETUP command controls the way in which traces 
will be stored on the memory card. Traces may be enabled (FILE) 
or disabled (DIS) for storage. This applies to autostoring or to the 
CARD_STORE STST command. Traces may be autostored to the 
memory card after each acquisition until the card becomes full 
(FILL), or forever (WRAP), replacing the oldest traces by new 
ones. They may be stored keeping the full precision of the data 
(WORD), or with reduced precision (BYTE, most significant bits 
only) to conserve space on the card. 

The STOREJSETUP? query returns the current mode of opera- 
tion of Autostore, the current data size, and the current trace 
selection. 

STore jSeTup [<trace>,<enable>, . . . ,<trace>,<enable>] 
[,AUTO,<mode>] [,SIZE,<data size>] 

<trace> := {EA, EB, MC, MD, FE, FF, Cl, C2, C3t, C4$} 
<enable> := {FILE, DIS} 

<mode> := {OFF, WRAP, FILL} 

<data_size := {WORD, BYTE} 

Note 1: Parameters are grouped in pairs. The first one names the 
variable to be modified and the second one gives the new value to 
be assigned. Pairs may be given in any order and may be restricted 
to those variables which have to be changed. 

Note 2: The STOREJSETUP command only modifies the current 
setup for storing traces to the memory card. Any parameters not 
given in a particular STORE _SETUP command will not be af- 
fected, i.e. they will stay at their previous settings . 

STore_SeTup? 

STorejSeTup <trace>,<enable>, . . . ,<trace>,<enable>, AUTO, 
<mode>,SIZE,<size> 
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£ System Commands 



EXAMPLE (GPIB) 



RELATED COMMANDS 



The following command selects Channel 1 and Channel 2 traces to 
be stored. It prevents Expansion A from being stored (DIS) and 
enables an “autostore” to the card until no more space is left on 
the memory card (AUTO, FILL). Every data point will be trans- 
ferred to the card in BYTE format. 

CMD$="STST Cl, FILE, C2.FILE, EA.DIS, AUTO, FILL, 
SIZE, BYTE” :CALL IBWRT(SCOPE%,CMD$) 

STORE, INR? 
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WAVEFORM TRANSFER 
DESCRIPTION 



COMMAND SYNTAX 
EXAMPLE (GPIB) 

RELATED COMMANDS 



STORE_TEMPLATE, STTM 

Command 

Oscilloscopes fitted with the MC01 Option 

The STORE_TEMPLATE command stores the instrument’s 
waveform template on the memory card. A filename is automati- 
cally generated in the form of “LECROYw.TPL” where “vv” is 
the 2-digit revision number. 

Note: As an example, the file name generated will be 
LECROY21.TPL for revision 2.1. 

Refer to Section 6 for further information about the waveform 
template. 

ST ore_TeMplate 

The following code stores the current waveform template on the 
memory card for future reference. 

CMD$=”STTM”:CALL IBWRT(SCOPE%,CMD$) 
TEMPLATE? 
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£ System Commands 



WAVEFORM TRANSFER 

DESCRIPTION 

QUERY SYNTAX 
Response format 

RELATED COMMANDS 



TEMPLATE?, TMPL? 

Query 



The TEMPLATE? query produces a copy of the template which 
formally describes the various logical entities making up a com- 
plete waveform. In particular, the template describes in full detail 
the variables contained in the descriptor part of a waveform. Refer 
to Section 6 for further information. 

TeMPLate? 

TeMPLate “<template>” 

<template> := A variable length string detailing the structure of 
a waveform. 

INSPECT? 
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System Commands £) 



ACQUISITION 

DESCRIPTION 



COMMAND SYNTAX 

QUERY SYNTAX 
Response Format 

$ 2 ns/div for Model 9430 



TIME_DIV, TDIV 

Command/Query 



The TIME_DIV command modifies the time-base setting. The 
new time-base setting may be specified with suffixes NS for 
nanoseconds, US for microseconds, MS for milliseconds, S for 
seconds or KS for kiloseconds. An out-of-range value causes the 
VAB bit (bit 2) in the STB register (Table 8, STB) to be set. 

The oscilloscope will force random interleaved sampling (RIS) for 
time-base settings in the “ON” only range, and single-shot sam- 
pling for time-base settings in the “OFF” only range. For 
time-base settings in the “Selectable” range, the INTERLEAVED 
command allows the user to choose the required sampling mode. 



RIS 


9410/14 


9420/24/30 


9450 


“ON" 

only 


2 ns/div 
to 

20 ns/div 


1 ns/div^- 
to 

20 ns/div 


1 ns/div 
to 

5 ns/dlv 


Selectable 

“ON”/“OFF" 


50 ns/div 
to 

5 jis/div 


50 ns/div 
to 

20 jxs/div 


10 ns/div 
to 

5 p,s/div 


“OFF” 

only 


10 p.s/div 
to 

1000 s/div 


50 p.s/div 
to 

5000 s/div 


10 jis/div 
to 

5000 s/dlv 



Sequence mode acquisitions also force single-shot sampling and 
therefore cannot be performed for time-base settings in the RIS 
“ON” only range (see table above). 

The TIMEJ3IV? query returns the current time-base setting. 

Time_DIV <value> 

<value> := 1 NS to 5 KS 

Note: The suffix S (seconds) is optional. 

TimeJDIV? 

Time DIV <value> 
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£ System Commands 



EXAMPLE (GPIB) 



RELATED COMMANDS 



The following command sets the time base to 500 jisec/div. 
CMD$=”TDIV 500US”: CALL IBWRT(SCOPE%,CMD$) 
The following command sets the time base to 2 msec/div. 
CMD$=’’TDIV.002”: CALL IBWRT(SCOPE%,CMD$) 

INTERLEAVED, TRIG_DELAY, TRIG_MODE 
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DISPLAY 

DESCRIPTION 

COMMAND SYNTAX 

QUERY SYNTAX 
Response format 

EXAMPLE (GPIB) 



$ 4-channel oscilloscopes only 



TRACE, TRA 

Command/Query 



The TRACE command enables or disables the display of a trace. 
An environment error (Table 6, page 84) is set if an attempt is 
made to display more than four waveforms. 

The TRACE? query indicates whether the specified trace is dis- 
played or not. 

<trace>:TRAce <mode> 

<trace> := {Cl, C2, C3$, C4$, EA, EB, MC, MD, FE, FF} 
<mode> := {ON, OFF} 

<trace>:TRAce? 

<trace>:TRAce <mode> 

The following command displays Function E (FE). 
CMD$=”FE:TRA ON”: CALL IBWRT(SCOPE%,CMD$) 
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ACQUISITION 

DESCRIPTION 

COMMAND SYNTAX 
EXAMPLE (GPIB) 

RELATED COMMANDS 



*TRG 

Command 

The *TRG command executes an ARM command. 

Note: The *TRG command is the equivalent of the 488.1 GET 
(Group Execute Trigger) message. 

*TRG 

The following command enables signal acquisition. 
CMD$=”*TRG”: CALL IBWRT(SCOPE%,CMD$) 

ARM_ACQUISITION, STOP, WAIT 
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System Commands 



ACQUISITION 



TRIG_COUPLING, TRCP 

Command/Query 



DESCRIPTION The TRIG_COUPLING command sets the coupling mode of the 

specified trigger source. The trigger slope is automatically changed 
to positive when the trigger coupling is set to HFDIV. 

Note: HFDIV is indicated as HF on the front panel. See the Oper- 
ator's Manual , Section 5 (9424) or Section 6 (9450/20). 

The TRIG_COUPLING? query returns the trigger coupling of the 
selected source. 

COMMAND SYNTAX <trig_source>:TRig_CouPling <trig_coupling> 





9410/14/30 


9420/50 


9424 


9424E 


<tr ig_ source> := 


{Cl ,C2,EX,EX10) 


{Cl ,C2,EX,EX10} 


{Cl ,C2,C4} 


{C1.C2.EX} 


< trig^coupling > := 


{AC,DC,HFREJ,LFREJ} 


{AC, DC, HFREJ, LFREJ, HFDIV} 



QUERY SYNTAX 
Response format 

EXAMPLE (GPIB) 



RELATED COMMANDS 



<trig_source>:TRig_CouPling? 

<trig_source>:TRig__CouPling <trig_coupling> 

The following command sets the coupling mode of the trigger 
source Channel 2 to high frequency reject. 

CMD$=”C2:TRCP HFREJ”: CALL IBWRT(SCOPE%,CMD$) 
TRIG SELECT 
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System Commands 



ACQUISITION 

DESCRIPTION 



COMMAND SYNTAX 



QUERY SYNTAX 
Response format 

EXAMPLE (GPIB) 
RELATED COMMANDS 



TRIG_DELAY, TRDL 

Command/Query 



The TRIG_DELAY command sets the time at which the trigger is 
to occur with respect to the first acquired data point (displayed at 
the left hand edge of the screen). 

The command expects positive trigger delays to be expressed as a 
percentage of the full horizontal screen (this mode is called pre- 
trigger acquisition as data are acquired before the trigger occurs). 
Negative trigger delays must be given in seconds (this mode is 
called post-trigger acquisition as the data are acquired after the 
trigger has occurred). 

If a value outside the range -10 000 div X time/div and 100% is 
specified, the trigger time will be set to the nearest limit and the 
VAB bit (bit 2) will be set in the STB register. 

The response to the TRIG_DELAY? query indicates the trigger 
time with respect to the first acquired data point. Positive times are 
expressed as a percentage of the full horizontal screen and nega- 
tive times in seconds. 

TRig_DeLay <value> 

<value> := 0.00 PCT to 100.00 PCT (pretrigger) 

-20 PS to -50 MAS (post-trigger) 

Note : The suffix is optional . For positive numbers the suffix PCT 
is assumed. For negative numbers the suffix S is assumed. MAS is 
the suffix for Msec (megaseconds) > useful only for extremely large 
delays at very slow time bases. 

TRig_DeLay? 

TRig^DeLay <value> 

The following command sets the trigger delay to - 20 sec (post- 
trigger) 

CMD$=”TRDL -20S”: CALL IBWRT(SCOPE% t CMD$) 

TIME DIV 
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System Commands 



ACQUISITION TRIG_LEVEL, TRLV 

Command/Query 



DESCRIPTION The TRIG_LEVEL command adjusts the trigger level of the speci- 

fied trigger source. An out-of-range value will be adjusted to the 
closest legal value and will cause the VAB bit (bit 2) in the STB 
register (Table 8, page 137 ) to be set. 

The range of values is as follows: 

± 5 times the total V/div setting - with CHAN 1, 2 or 4 as 
trigger source. 

± 2 V with EXT as trigger source (± 0.8 V in 9424E) 

± 20 V with EXT/ 10 as trigger source. 



The TRIG_LEVEL? query returns the current trigger level. 
COMMAND SYNTAX <trig_source>:TRig_LeVel <trig_level> 





2-channel 

oscilloscopes 


4-channel 
with Ext trigger 


4-channel 
without Ext trigger 


<trig^source> := 


{Cl ,C2,EX,EX10) 


{C1.C2.EX, EX10&} 


{C1.C2.C4} 



QUERY SYNTAX 
Response format 
EXAMPLE (GPIB) 



RELATED COMMANDS 



<trig_level> := -20V to 20V (maximum range) 

Note: The suffix V is optional. 

<trig_source>:TRig_LeVel? 

<trig source>:TRig LeVel <trig_level> 

The following command adjusts the trigger level of Channel 2 to 
-3.4 V. 

CMD$=”C2:TRLV -3.4V”: CALL IBWRT(SCOPE%,CMD$) 
TRIG_SELECT 



* Not available in 9424E 



151 











^ System Commands 



ACQUISITION 

DESCRIPTION 

COMMAND SYNTAX 

QUERY SYNTAX 
Response format 

EXAMPLE (GPIB) 
RELATED COMMANDS 



TRIGJVIODE, TRMD 

Command/Query 



The TRIG_MODE command specifies the trigger mode. An envi- 
ronment error (Table 6, page 84) will be generated when TRMD 
SEQNCE is received while the instrument is in the interleaved 
sampling (RIS) acquisition mode. With the mode SINGLE, this 
command will not arm the trigger. Use the command ARM_AC- 
QUISITION to actually start a single acquisition. 

The TRIG_MODE? query returns the current trigger mode. 
TRig_MoDe <mode> 

<mode> := {AUTO, NORM, SEQNCE, SINGLE, WRAP} 

TRig_MoDe? 

TRig_MoDe <mode> 

The following command selects the sequence mode. 
CMD$=”TRMD SEQNCE”: CALL IBWRT(SCOPE%,CMD$) 

ARM_ACQUISITION, STOP, TRIG_SELECT 
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ACQUISITION 

DESCRIPTION 



COMMAND SYNTAX 

QUERY SYNTAX 
Response format 

EXAMPLE (GPIB) 
RELATED COMMANDS 



TRI G PATTERN , TRPA 

(2-ch. and 4-ch. oscilloscopes with external trigger) 

Command/Query 



The TRIG_PATTERN command defines a trigger pattern. The 
command specifies the logic composition of the pattern sources 
(Channel 1, Channel 2, External) and the conditions under which 
a trigger can occur. Note that this command can be used even if 
the complex trigger mode has not been activated. 



Notation 




L 


Low 




H 


High 




X 


Don’t Care 




PR 


pattern present 


AB pattern absent 


EN 


pattern entered 


EX pattern exited 



The TRIG_PATTERN? query returns the current trigger pattern. 

TRig_PAttern <C l_state>,<C2_state>,<EX_state>,<trig_condi- 
tion> 

<Cl_state> := {L,H,X} 

<C2_state> := {L,H,X} 

<EX_state> := {L,H,X} 

<trig_condition> := {PR, AB, EN, EX} 

TRig_PAttern? 

TRig_PAttern <C l_state>,<C2_state>,<EX_state>,<trig_condi- 
tion> 

The following command configures the logic state of the pattern as 
HLX (CHI = H, CH2 = L, EX = X) and defines the trigger con- 
dition as pattern absent (AB). 

CMD$=”TRPA H,L,X,AB”: CALL IBWRT(SCOPE%,CMD$) 
TRIG SELECT 
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^ System Commands 



ACQUISITION 

DESCRIPTION 



COMMAND SYNTAX 

QUERY SYNTAX 
Response format 

EXAMPLE (GPIB) 
RELATED COMMANDS 



TRIG PATTERN, TRPA 

(4-channel oscilloscopes without external trigger) 

Command/Query 

The TRIG_PATTERN command defines a trigger pattern. The 
command specifies the logic composition of the pattern sources 
(Channel 1, Channel 2, and Channel 4) and the conditions under 
which a trigger can occur. Note that this command can be used 
even if the complex trigger mode has not been activated. 



Notation 




L 


Low 




H 


High 




X 


Don’t Care 




PR 


pattern present 


AB pattern absent 


EN 


pattern entered 


EX pattern exited 



The TRIG_PATTERN? query returns the current trigger pattern. 

TRig__PAttern <Cl_state>,<C2_state>,<C4_state>,<trig_condi- 
tion> 

<Cl_state> := {L,H,X} 

<C2_state> := {L,H,X} 

<C4_state> := {L,H,X} 

<trig_condition> := {PR, AB, EN, EX} 

TRig_PAttern? 

TRig_PAttern <C l_state>,<C2_state>,<C4_state>,<trig_condi- 
tion> 

The following command configures the logic state of the pattern as 
HLX (CHI = H, CH2 = L, CH4 = X) and defines the trigger con- 
dition as pattern absent (AB). 

CMD$=”TRPA H,L,X, AB” : CALL IBWRT(SCOPE%,CMD$) 
TRIG SELECT 
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System Commands £ 



ACQUISITION 



TRIG_SELECT, TRSE 

Command/Query 



DESCRIPTION The TRIG_SELECT command selects the condition that will trig- 

ger the acquisition of waveforms. Depending on the trigger type, 
additional parameters have to be specified. 

The additional parameters are grouped in pairs. The first one 
names the variable to be modified and the second one gives the 
new value to be assigned. Pairs may be given in any order and may 
be restricted to those variables to be changed. 

Note : The state-qualified , time /event qualified and pattern trigger 
types use the trigger pattern defined by the command TRIG - 
GER_PA TTERN. 

The TRIGJSELECT? query returns the current trigger condition. 



Trigger Notation 



STD 


Standard 


SNG 


Single source 


PA 


Pattern 


SQ 


State qualified 


TEQ 


Time event qualified 


Tl 


Time 


PL 


Pulse larger 


IL 


Interval larger 


EV 


Event 


PS 


Pulse smaller 


IS 


Interval smaller 


SR 


Source 


HT 


Hold type 


HV 


Hold value 


TV Trigger Notation 






FLD 


Field 


FLDC 


Field Count 


LINE 


Line 


CHAR 


Characteristics 


LPIC 


Lines per picture 


ILAC 


Interlace 



SR does not apply to the Pattern trigger. 

HT and HV do not apply to the standard trigger. 



NON TV TRIGGER 

COMMAND SYNTAX TRig_SElect <trig_type>,SR,<source>,HT,<hold_type>, 

HV,<hold_value> 

<trig_type> := {STD, SNG, SQ, TEQ, PA} 

<source> := {Cl, C2, LINE, EX, EX10 & }t 

<source> := {Cl, C2, LINE, C4}@ 

$ 2-ch. and 4-ch. oscilloscopes with ext. trigger, & Not available in 9424E, @ 4-ch. oscilloscopes without ext. trigger 
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^ System Commands 



QUERY SYNTAX 
Response format 

EXAMPLE (GPIB) 

TV TRIGGER 
COMMAND SYNTAX 



QUERY SYNTAX 
Response format 

® for CUST50 and CUST60 only 



<hold_type> := {TI, EV, PS, PL, IS, IL} 

<hold_value> := 25NS to 20S for TI 
1 to 10 9 for EV 
2.5NS to 20S for PS and PL* 

IONS to 20S for IS* 

25NS to 20S for IL* 

* these values are only valid for single-source and pattern triggers. 
Note: The suffix S (seconds) is optional. 



TRig_SElect? 

TRig SElect <trig_type>,SR,<source>,HT,<hold_type>, 
HV,<hold_value> 

The following command selects the single-source trigger with 
Channel 1 as trigger source. Hold type and hold value are chosen 
as “Pulse smaller” than 20 psec 

CMD$="TRSE SNG.SR.Cl.HT, PS,HV,20 US” 

CALL IBWRT(SCOPE%,CMD$) 



TRig_SElect TV,SR,<source>,FLDC,<field_count>,FLD,<field>, 
CHAR,<characteristics>,LPIC@’<lpic>,ILAC@,<ilace>, 
LINE,<line> LINE,<line> 

<source> := EX in 2-channel oscilloscopes 
<source> := C3 in 4-channel oscilloscopes 
<field_count> := {1, 2, 4, 8} 

<field> := 1 to field_count 

<characteristics> := { NTSC,PALSEC,CUST50,CUST60} 

<lpic> := 1 to 1500 
<ilace> := {1, 2, 4, 8} 

<line> := 1 to 1500 

Note: The FLD value is interpreted with the current FLDC value. 
The LINE value is interpreted with the current FLD and CHAR 
values. 

TRig SElect? 

TRig_SElect TV,SR,EX,FLDC,<field_count>,FLD,<field>, 
CHAR, <characteristic>, LINE, <line> 
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System Commands 



EXAMPLE (GPIB) 
RELATED COMMANDS 



CMD$ = ”TRSE TV,SR,EX,FLDC,8,FLD,3,CHAR, 
PALSEC,LINE, 17" 



TRIG_COUPLING, TRIG_LEVEL, TRIG_MODE, TRIG_PAT- 
TERN, TRIG_SLOPE 
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^ System Commands 



ACQUISITION 



TRIGJSLOPE, TRSL 

Command/Query 



DESCRIPTION The TRIGJSLOPE command sets the trigger slope of the specified 

trigger source. An environment error (see Table 6, page 84) will 
be generated when TRSL NEG is received while the trigger cou- 
pling is set to HFDIV (see TRIG_COUPLIN G). 

The TRIG_SLOPE? query returns the trigger slope of the selected 
source. 



COMMAND SYNTAX <trig^source>:TRig_SLope <trig_slope> 





2-channel 

oscilloscopes 


4-channel 
with Ext trigger 


4-channel 
without Ext trigger 


<trig_source> ;= 


{Cl ,C2,EX,EX10} 


{C1.C2.EX, EX10 a } 


{Cl ,C2,C4} 



<trig_slope> := {NEG, POS} 

<trig_source>:TRig_SLope? 

<trig_source> :TRig__SLope <trig__slope> 

The following command sets the trigger slope of Channel 2 to 
negative. 

CMD$=”C2:TRSL NEG”: CALL IBWRT(SCOPE%,CMD$) 
TRIG SELECT 



& Not available in 9424E 



QUERY SYNTAX 
Response format 

EXAMPLE (GPIB) 
RELATED COMMANDS 
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System Commands 



MISCELLANEOUS 

DESCRIPTION 

QUERY SYNTAX 
Response Format 

EXAMPLE (GPIB) 
RELATED COMMANDS 



*TST? 

Query 



The *TST? query performs an internal self-test. The response in- 
dicates if the self-test detected any errors. The self-test includes 
testing the hardware of all channels, the time base and the trigger 
circuits. 

Hardware failures are identified by a unique binary code in the 
returned <status> number (see Table 1, page 46) . A “0” response 
indicates that no failures occurred. 

Note: This query is only accepted in remote mode. 

*TST? 

*TST <status> 

<status>:= 0 self-test successful 

This example causes a self-test to be performed. 

CMD$=” *TST?”: CALL IBWRT(SCOPE%,CMD$) 

CALL IBRD(SCOPE%,RD$): PRINT RD$ 

Response message (if no failure) 

*TST 0 

*CAL? 
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STATUS 

DESCRIPTION 

QUERY SYNTAX 
Response format 

EXAMPLE (GPIB) 
RELATED COMMANDS 



URR? 

Query 



The URR? query reads and clears the contents of the User Request 
status Register (URR) . The URR register specifies which button in 
the menu field was pressed. Refer to Table 9 for further details. 

In the remote mode, the URR register indicates the last button 
(2 ... 10) which was pressed. In local mode, the URR register indi- 
cates whether the CALL HOST button has been pressed. If no 
menu button has been pressed since the last URR? query, the 
value 0 is returned. Figure 1, (page NO TAG) shows the button 
assignments on the instrument. 

URR? 

URR <value> 

<value> := 0 to 9, 100 

The following instruction reads the contents of the URR register. 

CMD$=”URR?”: CALL IBWRT(SCOPE%,CMD$) 

CALL IBRD(SCOPE%,RSP$): PRINT RSP$ 

Response message 
URR 0 

CALL_HOST, KEY, ALL_STATUS?, *CLS 



Value 


Description 


0 


no button has been pressed 


i 


button 1 has been pressed. 


2 


button 2 has been pressed. 


3 


button 3 has been pressed. 


4 


button 4 has been pressed. 


5 


button 5 has been pressed. 


6 


button 6 has been pressed. 


7 


button 7 has been pressed. 


8 


button 8 has been pressed. 


9 


button 9 has been pressed. 


100 


The “Call Host" key (button 10 
in root menu) has been pressed. 



User Request Status Register Structure (URR) 
Table 9 
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System Commands 



DISPLAY 

DESCRIPTION 

COMMAND SYNTAX 

QUERY SYNTAX 
Response format 
EXAMPLE (GPIB) 

RELATED COMMANDS 



VERT_MAGNIFY, VMAG 

Command/Query 



The VERT_MAGNIFY command vertically expands the specified 
trace. The command is executed even if the trace is not displayed. 

The VERT_MAGNIFY? query returns the magnification factor of 
the specified trace. 

<trace>:Vert_MAGnify <factor> 

<trace> := {EA, EB, MC, MD, FE, FF} 

<factor> := 0.2 to 50 (maximum) 

<trace>:Vert_MAGnify? 

<trace>:Vert_MAGnify <factor> 

The following command enlarges the vertical amplitude of Func- 
tion E by a factor of 3.45 with respect to its original amplitude. 

CMD$=”FE:VMAG 3.45”: CALL IBWRT(SCOPE%,CMD$) 
VERT_POSITION 
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System Commands 



DISPLAY 

DESCRIPTION 



COMMAND SYNTAX 

QUERY SYNTAX 
Response format 

EXAMPLE (GPIB) 
RELATED COMMANDS 



VERT_POSITION, VPOS 

Command/Query 



The VERT_POSITION command adjusts the vertical position of 
the specified trace on the screen. The VERT_POSITION com- 
mand does not affect the original offset value obtained at 
acquisition time. 

The VERT_POSITION? query returns the current vertical posi- 
tion of the specified trace. 

<trace>:Vert_POSition <display_offset> 

<trace> := {EA, EB, MC, MD, FE, FF} 

<display_offset> := -56 DIV to 56 DIV 

Note: The suffix DIV is optional. 

<trace>:Vert_POSition? 

<trace>:Vert_POSition <display_offset> 

The following command shifts Expand A (EA) upwards by +3 divi- 
sions, relative to the position at the time of acquisition. 

CMD$=” EA: VPOS 3DIV”: CALL IBWRT(SCOPE%.CMD$) 
VERT MAGNIFY 
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System Commands ^ 



ACQUISITION 

DESCRIPTION 



COMMAND SYNTAX 



QUERY SYNTAX 
Response format 

EXAMPLE (GPIB) 



t 4-channel oscilloscopes only 



VOLT_DIV, VDIV 

Command/Query 



The VOLT_DIV command sets the vertical sensitivity in Volts/div. 
The VAB bit (bit 2) in the STB register (Table 8, page 137 ) is set if 
an out-of-range value is entered. 

Note: The probe attenuation factor is not taken into account for 
adjusting vertical sensitivity . 

The VOLT_DIV? query returns the vertical sensitivity of the speci- 
fied channel. 

<channel>:Volt_DIV <v_gain> 

<channel> := {Cl, C2, C3J, C4$} 



9410/14/30 


All others 


1 mV to 2.5 V 


5.0 mV to 2.5 V 



Note : The suffix V is optional. 

<channel>:Volt_DIV? 

<channel>:Volt_DIV <v_gain> 

The following command sets the vertical sensitivity of channel 1 to 
50 mV/div. 

CMD$=”C1:VDIV 50MV”: 

CALL IB WRT (SCOPE%,CMD$) 
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^ System Commands 



STATUS 

DESCRIPTION 



Command syntax 
RELATED COMMANDS 



*YVAI 

Command 



The *WAI (WAIt to continue) command, required by the IEEE 
488.2 standard, has no effect on the oscilloscope as the oscillo- 
scope only starts processing a command when the previous 
command has been entirely executed. 

Note: This command can be executed in both local and remote 
modes. 

*WAI 

•OPC 
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System Commands 



ACQUISITION 

DESCRIPTION 

COMMAND SYNTAX 
EXAMPLE 



WAIT 

Command 



The WAIT command prevents the instrument from analyzing new 
commands until the oscilloscope has completed the current acqui- 
sition process. 

WAIT 

send: ”TRMD SINGLE” 
loop {send: "ARM; WAIT;C1:PAVA? MAX” 
read response 
process response 
} 

This example finds the maximum amplitudes of several signals ac- 
quired one after another. ARM starts a new data acquisition. The 
WAIT command ensures that the maximum is evaluated for the 
newly acquired waveform. 

”C1:PAVA? MAX” instructs the instrument to evaluate the maxi- 
mum data value in the Channel 1 waveform. 



* 

B 
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£ System Commands 



WAVEFORM TRANSFER 



DESCRIPTION 



COMMAND SYNTAX 



QUERY SYNTAX 



t 4-channel oscilloscopes only 



WAVEFORM, WF 

Command/Query 



A WAVEFORM? query transfers a waveform from the oscillo- 
scope to the controller, whereas a WAVEFORM command 
transfers a waveform from the controller to the oscilloscope. 

The WAVEFORM command stores an external waveform back 
into the oscilloscope’s internal memory. A waveform consists of 
several distinct entities: 

(1) the descriptor (DESC), 

(2) the user text (TEXT), 

(3) the time (TIME) descriptor, 

(4) the data (DAT1) block, and optionally 

(5) a second block of data (DAT2). 

For further information on the structure of the waveform refer to 
Section 6. In the 9424 the WAVEFORM command automatically 
sets the corresponding function to the memory state. 

Note: Only complete waveforms queried with "WAVEFORM? 
ALL" can be restored into the oscilloscope. 

The WAVEFORM? query instructs the oscilloscope to transmit a 
waveform to the controller. The entities may be queried independ- 
ently. If the “ALL” parameter is specified, all 4 or 5 entities are 
transmitted in one block in the order enumerated above. 

Note: The format of the waveform data depends on the current 
settings specified by the last WAVEF ORM _SETUP command, the 
last COMMjORDER command and the last COMM _F ORM AT 
command . 

<memory>:WaveForm ALL,<waveform_data_block> 

<memory>:= {MC, MD, FEJ:, FF$} 

<waveform_data_block> := arbitrary data block 

<trace>:WaveForm? <block> 

<trace>:= {EA, EB, MC, MD, FE, FF, Cl, C2, C3t, C4*} 
<block>:= {DESC, TEXT, TIME, DAT1, DAT2, ALL} 

Note: If no parameter is given ALL will be assumed. 
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System Commands ^ 



Response format 



EXAMPLE (GPIB) 



RELATED COMMANDS 



<trace>:WaveForm <block>,<waveform_data_block> 

Note: It may be convenient to disable the response header if the 
waveform is to be restored. Refer to command COMM _HEADER 
for further details. 



1) The following command reads the block DAT1 from Memory C 
and saves it in the file “MEMC.DAT”. The path header “MC:” 
is saved together with the data. 

FILES = “MEMC.DAT” 

CMDS = “MC:WF? DAT1” 

CALL IBWRT (SCOPE%,CMD$) 

CALL IBRDF(SCOPE%, FILES) 

2) In the following example, the entire contents of Channel 1 are 
saved in the file “CHAN1.DAT”. The path header “Cl:” is 
skipped to ensure that the data can later be recalled into the 
oscilloscope. 

FILES = “ CHAN 1 . DAT” :RD$=SPACE$ (3) 

CMDS = ”CHDR SHORT; C1:WF?” 

CALL IBWRT (SCOPE%,CMD$) 

CALL IBRD(SCOPE%,RD$) Skip first 3 characters “Cl:” 
CALL IBRDF(SCOPE%, FILES) Save data in the file 

“CHAN1.DAT” 

3) The following example illustrates how the waveform data saved 
in example 2) can be recalled into Memory C. 

FILES = “CHAN1.DAT” 

CMDS = MC:TRACE ON” 

CALL IBWRT (SCOPE%,CMD$) 

CALL IBWRTF(SCOPE%, FILES) 

The MC:TRACE ON command ensures that the <trace> is set 
to “MC”. When the data file is sent to the instrument, it first 
sees the header “WF” (the characters “Cl:” having been 
skipped when reading the file) and assumes the default destina- 
tion “MC”. 

INSPECT?, COMM_FORMAT, COMM-ORDER, FUNC- 

TION_STATEJ, TEMPLATE?, WAVEFORM_SETUP, 

WAVEFORM TEXT, 



I 

1 

« 



$ 4-channel oscilloscopes only 
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WAVEFORM TRANSFER 



DESCRIPTION 



WAVEFORM_SETUP, WFSU 

Command/Query 



The WAVEFORM_SETUP command specifies the amount of 
data in a waveform which will be transmitted to the controller. The 
command controls the settings of the following parameters: 



a. Sparsing (SP). The sparsing parameter defines the interval 
(0.. 25000) between data points. For example: 

SP = 0 reads all data points 
SP = 1 reads all data points 
SP = 4 reads every 4th data point 

b. Number of points (NP). The number of points parameter 
indicates how many points should be transmitted. For ex- 
ample: 

NP = 0 sends all data points 
NP = 1 sends 1 data point 
NP = 5 sends a maximum of 5 data points 
NP = 10 sends a maximum of 10 data points 

c. First point (FP). The first point parameter specifies the 
address of the first data point to be sent. For waveforms 
acquired in sequence mode, this refers to the relative ad- 
dress in the given segment. For example: 

FP = 0 corresponds to the first data point 
FP = 1 corresponds to the second data point 
FP = 5000 corresponds to data point 5001 

d. Segment number (SN). The segment number parameter 
indicates which segment should be sent if the waveform 
was acquired in sequence mode. This parameter is ignored 
for non-segmented waveforms. For example: 

SN = 0 all segments 
SN = 1 first segment 
SN = 23 segment 23 

The WAVEFORM_SETUP? query returns the transfer parame- 
ters currently in use. 



Notation 




SP sparsing 


NP number of points 


FP first point 


SN segment number 
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COMMAND SYNTAX 



QUERY SYNTAX 
Response format 

EXAMPLE (GPIB) 
RELATED COMMANDS 



WaveForm_SetUp SP,<sparsing>,NP,<number>,FP,<point>, 
SN,<segment> 





9410/14 


All others 


<sparsing> := 


0 to 5000 

(0 = no sparsing) 


0 to 25000 


<number> := 


0 to 10000 
(0 = all points) 


0 to 50000 


<point> := 


0 to 10000 


0 to 50000 


<segment> := 


0 to 50 

(0 = all segments) 


0 to 200 



Note 1: After power-on , all values are set to 0 (i.e. entire wave- 
forms will be transmitted without sparsing). 

Note 2: Parameters are grouped in pairs. The first one names the 
variable to be modified and the second one gives the new value to 
be assigned. Pairs may be given in any order and may be restricted 
to those variables to be changed. 

WaveForm_SetUp? 

WaveForm_SetUp SP,<sparsing>, NP,<number>, 

FP,<point>, SN,<segment> 

The following command specifies that every 3rd data point (SP=3) 
starting at address 200 should be transferred. 

CMD$=” WFSU SP,3,FP,200” 

CALL IBWRT(SCOPE%,CMD$) 

INSPECT?, WAVEFORM, TEMPLATE 
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WAVEFORM TRANSFER 
DESCRIPTION 

COMMAND SYNTAX 

QUERY SYNTAX 
Response format 

EXAMPLE (GPIB) 
RELATED COMMANDS 



$ 4-channel oscilloscopes only 



WAVEFORM JTEXT, WFTX 

Command/Query 



The WAVEFORM_TEXT command is used to document the con- 
ditions under which a waveform has been acquired. The text 
buffer is limited to 400 characters. 

The WAVEFORM_TEXT? query returns the text section of the 
specified trace. 

<trace>:WaveForm_TeXt *<text>’ 

<trace> := {EA, EB t MC, MD, FE, FF, Cl, C2, C3*, C4*} 
<text> := An ASCII message (max. 400 characters long) 

<trace>:WaveForm_TeXt? 

<trace>:WaveForm_TeXt “<text>” 

The following example shows how to document Function E (FE). 

MSGS = ,M Averaged pressure signal. 

Experiment carried out Oct. 15, 88*” 

CMD$ = ”FE:WFTX "+ MSGS 
CALL IBWRT (SCOPE%,CMD$) 

INSPECT?, WAVEFORM, TEMPLATE? 
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DISPLAY 

DESCRIPTION 



COMMAND SYNTAX 

QUERY SYNTAX 
Response Format 



EXAMPLE (GPIB) 



$ 4-channel oscilloscopes only 



XY_ASSIGN, XYAS 

Command/Query 



The XY_ASSIGN command assigns traces to the X and Y axis to 
create an X versus Y display. 

The XY_ASSIGN? query returns the traces currently assigned to 
the XY display. If there is no trace assigned to the X-axis and/or 
the Y-axis the value UNDEF will be returned instead of the trace 
name. 

XY_ASsign <X_source>,<Y_source> 

<X_source> := {EA, EB, MC, MD, FE, FF, Cl, C2, C3*, C4*} 
<Y_source> := {EA, EB, MC, MD, FE, FF, Cl, C2, C3t, C4$} 

XY_ASsign? 

XY_ASsign <X_source>,<Y_source> 

<X_source> := {UNDEF, EA, EB, MC, MD, FE, FF, Cl, C2, 
C3*, C4J} 

<Y_source> := {UNDEF, EA, EB, MC, MD, FE, FF, Cl, C2, 
C3i, C4*} 



The following command will assign Channel 1 to X and Channel 2 
to Y. 

CMDS$=”XYAS C1,C2”: CALL IBWRT(SCOPE%,CMDS$) 
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CURSOR 

DESCRIPTION 



COMMAND SYNTAX 

QUERY SYNTAX 
Response Format 

EXAMPLE (GPIB) 



XY_CURSOR_ORIGIN, XYCO 

Command/Query 



The XY_CURSOR_ORIGIN command sets the position of the ori- 
gin for absolute time cursor measurements on the XY display. 

Absolute time cursor values may be measured either with respect 
to the point (0,0) volts (OFF) or with respect to the center of the 
XY grid (ON). 

The XY_CURSOR_ORIGIN query returns the current assignment 
of the origin for absolute time cursor measurements. 

XY_Cursor_Origin <mode> 

<mode> := {ON, OFF} 

XY_Cursor_Origin? 

XY_Cursor_Origin <mode> 

The following command sets the origin for absolute time cursor 
measurements to the center of the XY grid. 

CMDS$=”XYCO ON”: CALL IBWRT(SCOPE%,CMDS$) 
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CURSOR 



DESCRIPTION 



COMMAND SYNTAX 



XY_CURSOR_SET, XYCS 

Command/Query 



The XY_CURSOR_SET command allows the user to position any 
one of the nine independent XY cursors at a given screen location. 
The positions of the cursors can be modified or queried even if the 
required cursor is not currently displayed or if the XY display 
mode is OFF. 

The XY_CURSOR_SET? query indicates the current position of 
the cursor (s) . The values returned are quoted relative to the origi- 
nal waveform (time or frequency domain). 



Notation 




HABS 


Horizontal absolute 


HREF 


Horizontal reference 


HDIF 


Horizontal difference 


XABS 


Vertical absolute on X axis 


XREF 


Vertical reference on X axis 


XDIF 


Vertical difference on X axis 


YABS 


Vertical absolute on Y axis 


YREF 


Vertical reference on Y axis 


YDIF 


Vertical difference on Y axis 



XY_Cursor_Set <cursor>,<position> 

[<cursor>,<position> . . . ,<cursor>,<position>] 

<cursor> := {HABS, HREF.HDIF, XABS, XREF.XDIF, YABS, 
YREF, YDIF} 

<position> := 0 to 10 DIV (horizontal) 

- 4 to 4 DIV (vertical) 

Note 1: The suffix DIV is optional. 

Note 2: Parameters are grouped in pairs. The first one names the 
cursor to be modified and the second one indicates its new value. 
Pairs may be given in any order and may be restricted to those 
items to be changed. 
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QUERY SYNTAX 

Response Format 
EXAMPLE (GPIB) 



XY_Cursor_Set? [<cursor f . . .<cursor>] 

<cursor> := {HABS, HREF, HDIF, XABS, XREF, XDIF, YABS, 
YREF, YDIF, ALL} 

Note: If <cursor> is not specified, ALL will be assumed. 

XY_Cursor_Set <cursor>,<position>[<cursor>,<position>. . . 

. . . ,<cursor>,<position>] 

The following command positions the XREF and YDIF at +3 DIV 
and -2 DIV respectively. 

CMDS$=”XYCS XREF, 3DIV, YDIF, -2DIV” 

CALL IBWRT(SCOPE%,CMDS$) 
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CURSOR 



DESCRIPTION 



Parameter Names 



QUERY SYNTAX 



Response Format 



EXAMPLE (GPIB) 



XY_CURSOR_VALUE, XYCV 

Command/Query 



The XY_CURSOR_VALUE? query returns the current values of 
the X versus Y trace parameters. The X versus Y trace does not 
need to be displayed to obtain these parameters, but valid sources 
must be assigned to the X and Y axes. 



ccursor type>_X 
ccursor type>_Y 
<cursor type>_RATIO 
<cursor type>_PROD 
ccursor type>_ANGLE 
ccursor type>_RADIUS 
ccursor_type> := [HABS, 



X 

Y 

AY/AX 
AY * AX 
arc tan(AY/AX) 
sqrt(AX* AX + AY* AY) 
HREL, VABS, VREL] 



X Y_Cursor_Value? [cparameter>, . . .cparameter>] 

cparameter> := {HABS_X, HABS_Y, HABS_RATIO, 
HABS_PROD, HABS_ANGLE, HABS_RADIUS, HREL_X, 
HREL_Y, HREL_RATIO, HREL_PROD, HREL_ANGLE, 
HREL_RADIUS, VABS_X, VABS_Y, VABS_RATIO, 
VABS_PROD, VABS_ANGLE, VABS_RADIUS, VREL_X, 
VREL_Y, VREL_RATIO, VREL_PROD, VREL_ANGLE, 
VREL_RADIUS, ALL} 

Note: If <parameter> is not specified or equals ALL, all the mea- 
sured cursor values are returned. If the value of a cursor could not 
be determined in the current environment, the value UNDEF will 
be returned. If no trace has been assigned to either the X axis or 
the Y axis, an environment error will be generated. 

XY_Cursor_Value cparameter>,cvalue> 

[. . . .cparameter>,cvalue>] 

cvalue> := decimal value or UNDEF 



The following query reads the ratio of the absolute horizontal cur- 
sor, the angle of the relative horizontal cursor and the product of 
the absolute vertical cursor. 

CMDS$=”XYCV? HABS_RATIO,HREL_ANGLE, 
VABS_PROD 

CALL IBWRT(SCOPE%,CMDS$) 
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DISPLAY 



XY_DISPLAY, XYDS 

Command/Query 



DESCRIPTION 



COMMAND SYNTAX 

QUERY SYNTAX 
Response Format 

EXAMPLE (GPIB) 



The XY_DISPLAY command enables or disables the XY display 
mode. 

The XY_DISPLAY? query returns the current mode of the XY 
display. 

XY_DiSplay <mode> 

<mode> := {ON, OFF} 

XY_DiSplay? 

XY_DiSplay <mode> 

The following command turns the XY display ON. 
CMDS$=”XYDS ON": CALL IBWRT(SCOPE%,CMDS$) 
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DISPLAY 

DESCRIPTION 



COMMAND SYNTAX 

QUERY SYNTAX 
Response format 

EXAMPLE (GPIB) 
RELATED COMMANDS 



$ 4-channel oscilloscopes only 



ZOOM 

Command/Query 



The ZOOM command allows the user to select which trace is to be 
expanded by one of the expansion functions. 

The response to the ZOOM? query indicates which trace is cur- 
rently expanded. 

In 4-channel oscilloscopes the ZOOM command automatically 
switches the function to the expand state. 

<e xpjxace>:ZOOM <trace> 

<exp_trace> := {EA, EB, MC$, MD|} 

<trace> := {MC, MD, FE, FF, Cl, C2, C3$, C4$} 



<ex P_trace >: ZOOM? 

<ex P_ trace>: ZOOM <trace> 

The following example selects Memory C (MC) as the source for 
Expand B (EB). 

CMD$=”EB:ZOOM MC”: CALL IBWRT(SCOPE%,CMD$) 
DUAL ZOOM 
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REMOTE CONTROL INDEX OF GPIB COMMANDS 



Full Command 


Abbrev. 


Page 


ALL STATUS? 


ALST? 


39 


ARM ACQUISITION 


ARM 


40 


ATTENUATION 


ATTN 


41 


AUTO CALIBRATE 


ACAL 


42 


AUTO SETUP 


ASET 


43 


BANDWIDTH LIMIT 


BWL 


44 


BUZZER 


BUZZ 


45 


*CAL? 


’"CAL? 


46 


CALL HOST 


CHST 


47 


*CLS 


-CLS 


48 


CMR? 


CMR? 


49 


COMM FORMAT 


CFMT 


50-51 


COMM HEADER 


CHDR 


52 


COMM HELP 


CHL 


53 


COMM ORDER 


CORD 


54-55 


COMM RS232 


CORS 


56-58 


COUPLING 


CPL 


59 


CURSOR MEASURE 


CRMS 


60 


CURSOR SET 


CRST 


61-62 


CURSOR VALUE? 


CRVA? 


63 


DATE 


DATE 


64 


DDR? 


DDR? 


65-66 


DEFINE 


DEF 


67-75 


DELETE FILE 


DELF 


76 


DIRECTORY LIST? 


DIR? 


77 


DISPLAY 


DISP 


78 


DUAL ZOOM 


DZOM 


79 


-ESE 


*ESE 


80 


*ESR? 


-ESR? 


81-82 


EXR? 


EXR? 


83-84 


FORMAT CARD 


FORD 


85-86 


FUNCTION RESET 


FRST 


87 


FUNCTION STATE 


FSTA 


88-89 


GRID 


GRID 


90 


HARDCOPY SETUP 


HCSU 


91-92 


HARDCOPY~TRANSMIT 


HCTR 


93 


HOR MAGNIFY 


HMAG 


94 


HOR POSITION 


HPOS 


95-96 


*IDN? 


-IDN? 


97 


INE 


INE 


98 


INR? 


INR? 


99 


INSPECT? 


INSP? 


100-101 


INTENSITY 


INTS 


102 


INTERLEAVED 


ILVD 


103 


-1ST? 


-1ST? 


104 


KEY 


KEY 


105-106 


MESSAGE 


MSG 


107 


MULTI ZOOM 


MZOM 


108 


OFFSET 


OFST 


109-110 


-OPC 


-OPC 


111 


-OPT? 


-OPT? 


112 


PANEL SETUP 


PNSU 


113 


PARAMETER VALUE? 


PAVA? 


114-115 



Full Command 


Abbrev. 


Page 


PASS FAIL CONDITION 


PFCO 


116 


PASS FAIL COUNTER 


PFCT 


117 


PASS FAIL DO 


PFDO 


118 


PASS FAIL MASK 


PFMS 


119 


PERSIST 


PERS 


120 


PER CURSOR SET 


PECS 


121-122 


PER CURSOR VALUE? 


PECV? 


123 


PERSIST SETUP 


PESU 


124 


*PRE 


-PRE 


125 


*RCL 


-RCL 


126 


RECALL PANEL 


REC 


127 


RECALL 


RCPN 


128 


-RST 


-RST 


129 


SAMPLE CLOCK 


SCLK 


130 


*SAV 


-SAV 


131 


SCREEN DUMP 


SCD 


132 


SEGMENTS 


SEGS 


133 


SELECT 


SEL 


134 


-SRE 


-SRE 


135 


-STB? 


-STB? 


136-137 


STOP 


STOP 


138 


STORE 


STO 


139 


STORE PANEL 


STPN 


140 


STORE SETUP 


STST 


141-142 


STORE TEMPLATE 


STTM 


143 


TEMPUTE? 


TMPL? 


144 


TIME DIV 


TDIV 


145-146 


TRACE 


TRA 


147 


-TRG 


-TRG 


148 


TRIG COUPLING 


TRCP 


149 


TRIG DELAY 


TRDL 


150 


TRIG LEVEL 


TRLV 


151 


TRIG MODE 


TRMD 


152 


TRIG PATTERN (+ ext. trig.) 


TRPA 


153 


TRIG PATTERN (- ext. trig.) 


TRPA 


154 


TRIG SELECT 


TRSE 


155-157 


TRIG SLOPE 


TRSL 


158 


-TST? 


-TST? 


159 


URR? 


URR? 


160 


VERT MAGNIFY 


VMAG 


161 


VERT POSITION 


VPOS 


162 


VOLT DIV 


VDIV 


163 


-WAl 


WAl 


164 


WAIT 


WAIT 


165 


WAVEFORM 


WF 


166-167 


WAVEFORM SETUP 


WFSU 


168-169 


WAVEFORM TEXT 


WFTX 


170 


XY ASSIGN 


XYAS 


171 


XY CURSOR ORIGIN 


XYCO 


172 


XY CURSOR SET 


XYCS 


173-174 


XY CURSOR VALUE 


XYCV 


175 


XY DISPLAY 


XYDS 


176 


ZOOM 


ZOOM 


177 
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6 



INTRODUCTION 



LOGICAL DATA BLOCKS 
OF A WAVEFORM 



WAVEFORM STRUCTURE 



This section discusses how to read and write waveforms and under- 
stand their contents. Waveforms can be divided into two basic 
entities, the basic data array (i.e. the raw data values from the 
ADC’s in the acquisition) and the accompanying descriptive infor- 
mation, such as vertical scale, horizontal scale, time of day, which 
are necessary for a full understanding of the data. 

The information in a waveform can be accessed using the IN- 
SPECT? query which interprets it in an easily understood ASCII 
text form. It can also be more rapidly transferred using the 
WAVEFORM? query or written back into the instrument with the 
WAVEFORM command. The oscilloscope contains a data struc- 
ture called the template which is a detailed description of how the 
waveform’s information is organized. 



The template gives a detailed description of the form and contents 
of the logical data blocks of a waveform. It is provided as a refer- 
ence to be used by you and your programs. A sample template is 
given in Appendix B although you are encouraged to use the 
TEMPLATE? query to examine the actual template that your in- 
strument is using. The template may change as the instrument’s 
firmware is enhanced. The template will help provide backward 
compatibility for the interpretation of waveforms. 

Usually, a waveform will contain just a Waveform descriptor block 
(1.) and a Data array block (5.). In more complicated cases one 
or more of the other blocks will be present. The data blocks are: 

1. Waveform descriptor block (WAVEDESC). This block in- 
cludes all the information necessary to reconstitute the display 
of the waveform from the data. This includes: 

• hardware settings at the time of acquisition 

• the exact time of the event 

• the kinds of processing that have been performed 

• the name and serial number of the instrument 

• the encoding format used for the data blocks 

• miscellaneous constants 

2. An optional user-provided text (USERTEXT). The WFTX 
command can be used to put a title or description of a wave- 
form into this block. The WFTX? query command gives an 
alternative way to read it. This text block can hold up to 400 
characters. However, you should limit the length of each line to 
about 45 characters, otherwise the text will be wrapped onto 
the next line after 56 characters. 

3. A block of sequence acquisition times (TRIGTIME). This 
block is needed for sequence acquisitions to record the exact 
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Waveform Structure 



timing information for each segment. It contains the time of 
each trigger relative to the trigger of the first segment, as well as 
the time of the first data point of each segment relative to its 
trigger. 

4. A block of random interleaved sampling times (RISTIME). 
This block is needed for RIS acquisitions to record the exact 
timing information for each segment. 

5. A data array block (SIMPLE or DATA_ARRAY_1) . This is 
the basic integer data of the waveform. It can be raw or cor- 
rected ADC data or the integer result of waveform processing. 

6. A second data array block (DATA_ ARRAY_2) . This second 
data array is needed to hold the results of processing functions 
such as the Extrema (WP01 option) or Complex FFT (WP02 
option). In such cases, the data arrays contain: 

Extrema FFT 

DATA_ARRAY_1 Roof trace Real part 

DATA_ARRAY_2 Floor trace Imaginary part 

Note: The TEMPLATE also describes an array named DUAL. 
This is simply a way to allow the INSPECT ? command to examine 
the two data arrays together. 

INSPECT? COMMAND This is the simplest way to examine the contents of a waveform. It 

can be used on both the data and descriptive parts. The simplest 
form of the command is: 

INSPECT? “name” 

where the template gives the name of a descriptor item or data 
block. The answer is returned as a single string, but may span 
many lines. Here is some typical dialogue: 

question Cl: INSPECT? “VERTICAL_OFFSET” 
response Cl : INSP “VERTICAL_OFFSET : 1.5625e-03 
question Cl: INSPECT? "TRIGGER_TIME” 
response Cl: INSP ” 

TRIGGER_TIME : Date = FEB 17, 1989, Time = 4:4:29.5580 

The INSPECT? command can also be used to get a readable trans- 
lation of the full waveform descriptor block with the command: 

INSPECT? “ WAVEDESC” 

The template dump from your instrument (or from Appendix B) 
will give details on the interpretation of each of the parameters. 
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The INSPECT? command is also used to examine the measured 
data values of a waveform. For an acquisition with 42 points we 
get: 



INSPECT? “SIMPLE” 
C1:INSP ” 



4.68749e-03 


1.09375e-02 


1.71875e-02 


2.03125e-02 


2.03125e-02 


2. 65625e-02 


3.28125e-02 


3. 59375e-02 


3. 90625e-02 


4. 53125e-02 


5.15625e-02 


5. 15625e-02 


5.78125e-02 


6.40625e-02 


6.71875e-02 


6.71875e-02 


7.65625e-02 


7. 96875e-02 


8.59375e-02 


8. 90625e-02 


9.21875e-02 


9. 53125e-02 


1.04687e-01 


1.04687e-01 


1.07812e-01 


1 . 14062e-01 


1.20312e-01 


1 .20312e-01 


1.26562e-01 


1.29688e-01 


1.32812e-01 


1 . 39062e-01 


1.42187e-01 


1.51562e-01 


1.54687e-01 


1.57812e-01 


1.60938e-01 


1.60938e-01 


1.70312e-01 


L73437e-01 


1.70312e-01 


1.76563e-01 



n 



These numbers are the fully converted measurements in volts. Of 
course, when the data block contains thousands of items the string 
will contain many lines. 

Depending on the application, you may prefer to have the data in 
its raw form as either a BYTE (8 bits) or a WORD (16 bits) for 
each data value. In this case you must use the relations given below 
in association with the WAVEFORM? command to interpret the 
measurement. The command might then say: 

INSPECT? “SIMPLE”, BYTE 

The examination of data values for waveforms with two data arrays 
can be done as follows: 

INSPECT? “DUAL” to get pairs of data values on a single line 

INSPECT? “ D ATA_ARRAY_1 ” 

to get the values of the first data array 

INSPECT? “DATA_ARRAY_2” 

to get the values of the second data array 

It is also possible to examine just a part of the waveform or a 
sparsed form of the waveform. This is controlled with the WAVE- 
FORM_SETUP command mentioned later in this section. 

The INSPECT? command has only a query form. It cannot be 
used to send a waveform back into the oscilloscope. It is also a very 
verbose way in which to send the information and is not very fast. 
Users who need speed or the ability to send the waveform back to 
the instrument should use the WAVEFORM commands. 

BASIC users might find it convenient to combine the capabilities 
of the inspect facility with the waveform query command in order 
to construct files containing a human and BASIC readable version 
of the waveform descriptor together with the full waveform in a 
format suitable for retransmission to the instrument. This can be 
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WAVEFORM? COMMAND 



Interpreting the 
waveform descriptor 



done for a waveform in a memory location by sending the com- 
mand: 

MC:INSPECT? “ WAVEDESC” ;WAVEFORM? 
and putting the response directly into a disk file. 



The WAVEFORM commands are an efficient way to transfer 
waveform data using the block formats defined in the IEEE-488.2 
standard. You have the possibility of reading all of the logical 
blocks of the waveform with a single query: 

C 1 : WAVEFORM? 

This is the preferred form for most applications since it is complete 
and the response can be downloaded back into the instrument 
using the WAVEFORM command. You can also choose to read 
any single block with a query like: 

Cl: WAVEFORM? DAT1 

This can save time and space when you need to read many wave- 
forms all with the same acquisition conditions or if you are only 
interested in lots of raw integer data. Consult the description of the 
WAVEFORM command in Section 5 for the names of the various 
blocks. 

Please be aware that a waveform query response can easily be a 
block containing over 200,000 bytes if it is in binary format and 
twice as much if the HEX option is used. 



The binary response to a query command of the form: 

Cl .WAVEFORM? or Cl: WAVEFORM? ALL 
can be put into a disk file and then dumped to show the following 
hexadecimal and ASCII form: (This was done over GPIB with de- 
fault settings) 
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Byte Binary contents in hexadecimal 
offset 



0 


4331 


CA57 


4620 


414c 


4c2c 


2339 


16 


3030 


3433 


3057 


4156 


4544 


4553 


32 


0000 


0000 


004C 


4543 


524f 


595f 


48 


0000 


0000 


0000 


0100 


0000 


0001 


64 


0000 


0000 


0000 


0000 


0000 


0000 


80 


0000 


0000 


5400 


0000 


0000 


0000 


96 


004c 


4543 


524f 


5939 


3435 


305 f 


112 


0005 


alf4 


blOO 


0000 


0000 


0000 


128 


0000 


0000 


0000 


0000 


0000 


0000 


144 


2800 


0000 


0000 


0000 


2900 


0000 


160 


0100 


0000 


0000 


0000 


0100 


0000 


176 


0037 


4CCC 


cd3a 


cccd 


0046 


feOO 


192 


0000 


0800 


0031 


2bcc 


77be 


49fe 


208 


OObe 


4579 


8ee0 


0000 


0056 


0000 


224 


0000 


0000 


0000 


0000 


0000 


0000 


240 


0000 


0000 


0000 


0000 


0000 


0000 


256 


0000 


0000 


0000 


0000 


0053 


0000 


272 


0000 


0000 


0000 


0000 


0000 


0000 


288 


0000 


0000 


0000 


0000 


0000 


0000 


304 


0000 


0000 


0000 


0000 


0000 


0000 


320 


d913 


4ab0 


0004 


0401 


0407 


d200 


336 


0000 


0000 


0000 


0000 


0000 


OcOO 


352 


0000 


ofoo 


003 f 


8000 


003c 


8000 


368 


0004 


0006 


0007 


0007 


0009 


000b 


384 


ooof 


0011 


0011 


0013 


0015 


0016 


400 


001a 


001c 


OOld 


ooie 


OOlf 


0022 


416 


0025 


0027 


0027 


0029 


002a 


002b 


432 


0031 


0032 


0033 


0034 


0034 


0037 


448 


0039 


000a 











ASCII translation 
(b is for uninteresting) 



3030 


3030 


Cl : WF ALL ,#90000 


4300 


0000 


00430WAVEDESCbbb 


315 f 


3100 


bbbbbLECROY_l_lb 


5a00 


0000 


bbbbbbbbbbbbbbbb 


0000 


0000 


bbbbbbbbbbbbbbbb 


0000 


0000 


bbbbbbbbbbbbbbbb 


0000 


0000 


bLECROY9450_bbbb 


0000 


0000 




2a00 


0000 




0000 


0000 




0100 


0000 




00c7 


0000 




783b 


e800 




0000 


0000 




0000 


0000 




0000 


0000 




0000 


0000 




0000 


0000 




0000 


0000 




0040 


3d8e 




0000 


0000 




003f 


8000 




2000 


0002 




000c 


oood 




0016 


0019 




0022 


0023 




002d 


002e 




0038 


0037 





It can be seen that the first 10 bytes translate into ASCII and look 
like the simple beginning of a query response. This is followed by 
the string “#9000000430”. This is the beginning of a binary block 
where 9 ASCII integers are used to give the length of the block 
(430 bytes) . The waveform itself starts immediately after this at 
byte number 21 (the first byte is byte 0). 

Deciphering the waveform descriptor can be done with the aid of 
the template (see Appendix B) . It states that the first object is a 
DESCRIPTOR_NAME which is a string of 16 characters with the 
value WAVEDESC and this is what we see. At byte 16 relative to 
the beginning of the descriptor (or byte 37 above) we find the next 
string, the TEMPLATE_NAME with the value LECROY_l_l. 
Several other parameters follow. We can easily recognize the IN- 
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STRUMENTJSTAME at 76 bytes from the descriptor start (or byte 
97 above). 

In a similar way we learn that a 4 byte long integer giving the length 
of the descriptor starts at byte 36 (or byte 57 above): 

WAVE_DESCRIPTOR = 15a (hex) = 346 

At byte 60 (or byte 81 above) we find another 4 byte integer giving 
the length of the data array: 

WA VE_ ARR A Y_ 1 = 54 (hex) = 84 
and at byte 116 (or byte 137 above) the number of data points: 
WAVE_ARRAY_COUNT = 2a (hex) = 42 

Now we know that the data will start at byte 346 from the begin- 
ning of the descriptor (or byte 367 above) and that each of the 42 
data points will be represented by two bytes. The waveform has a 
total length of 346 + 84 which is the same as the ASCII string told 
us at the beginning of the block. The final 0a at byte 45 1 is the NL 
character associated with the GPIB message terminator 
<NLxEOI>. 

The data can be easily seen starting at byte 367 above. Since the 
example was taken using an oscilloscope with an 8 -bit ADC we see 
those 8 bits followed by a 0 byte for each data point. It should be 
noted that for oscilloscopes with 10-bit ADCs or for many other 
kinds of waveform this second byte will not be zero and contains 
interesting information. The data is coded in signed form (two’s 
complement) with values ranging from -32768 = 8000 (hex) to 
32767 = 7fff (hex). If we had chosen to use the BYTE option for 
the data format the values would have been signed integers in the 
range -128 = 80 (hex) to 127 = 7f (hex). 



Interpreting the 

waveform vertical data Now that we know how to decipher the data it would be useful to 

convert it to the appropriate measured values. The vertical reading 
for each data point depends on the vertical gain and the vertical 
offset given in the descriptor. For acquisition waveforms this corre- 
sponds to the volts/div and voltage offset selected after conversion 
for the data representation being used. The template tells us that 
the vertical gain and offset can be found at bytes 156 and 160 
respectively of the descriptor and that they are stored as floating 
point numbers in the IEEE 32 bit format. An ASCII string giving 
the vertical unit is to be found in VERTUNIT, byte 196. The verti- 
cal value is given by the relationship: 

value = VERTICAL_GAIN * data - VERTICAL_OFFSET 

A data value of 0 is normally displayed as a point in the middle of 
the grid. 
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Calculating the horizontal 
position of a data point 



In the case of the data shown above we find: 

VERTICAL_GAIN = 1. 220703 14e-05 from the floating 

point number 374c cccd at byte 177 

VERTICALJDFFSET = 1.56250596e-03 from the floating 

point number 3acc cdOO at byte 181 

VERTICAL_UNIT = V = volts from the string 5600 ... at byte 

217 



and therefore: 

since data[0] =512 from the hexadecimal word 0200 at byte 
367 

value [0] = 0.00468 V as stated in the inspect command 

above 



and 

since data[l] = 1024 from the hexadecimal word 0400 at byte 
369 

value [0] = 0.0109 V as stated in the inspect command 

above. 

If your computer or available software is incapable of understand- 
ing the IEEE floating point values you can find a description of this 
format in the template (see Appendix B). 

The data values in a waveform may not all correspond to measured 
points. The parameters, FIRST_VALID_PNT and LAST_VAL- 
ID_PNT give the necessary information. The descriptor also 
records the SPARSING_F ACTOR, the FIRST_POINT, and the 
SEGMENT_INDEX to aid interpretation if the options of the 
WAVEFORM_SETUP command have been used. 

For sequence acquisitions the data values for each segment are 
given in their normal order and the segments are read out one 
after the other. The important descriptor parameters are the 
W A VE_ A RR A Y_CO U NT and the SUBARRAY_COUNT, giving 
the total number of points and the number of segments. 

For waveforms such as the extrema and the complex FFT there 
will be two arrays one after the other for the two arrays of the 
result. 



Each vertical data value has a corresponding horizontal position, 
usually measured in time or in frequency units. The calculation of 
this position depends on the type of waveform being examined. 
We will treat separately the single sweep, the sequence, and the 
interleaved (RIS) waveform. Each data value has a position, i, in 
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the original waveform with i = 0 corresponding to the first data 
point acquired. The descriptor parameter HORUNIT gives a string 
with the name of the horizontal unit. 

• Single-sweep waveforms 

x [i] = HORIZ_INTERVAL * i + HORIZ_OFFSET 

For acquisition waveforms this time is from the trigger to the data 
point in question. It will be different from acquisition to acquisition 
since the HORIZ_OFFSET is measured for each trigger. 

In the case of the data shown above this means: 

HORIZ_INTERVAL = 2.5000e-09 from the floating point num- 
ber 312b cc77 at byte 197 

HORIZ_OFFSET = -1.21044098e-08 from the double preci- 
sion floating point number be49 fe78 
3be8 0000 at byte 201 

HORUNIT = S = seconds from the string 5300 ... at byte 
265 

which gives 

x [0] = -1.210e-08 S 

x[l] = -0.960e-08 S 

• Sequence waveforms 

Since sequence waveforms are really many independent acquisi- 
tions, each segment will have its own horizontal offset. These can 
be found in the TRIGTIME array. For the n’th segment 

x[i,n] = HORIZJNTERVAL * i + TRIGGER_OFFSET[n] 

The TRIGTIME array can contain up to 200 segments of timing 
information with two 8 byte double precision floating point num- 
bers for each segment. 

• Interleaved (RIS) waveforms 

These waveforms are composed of many acquisitions interleaved 
together. The descriptor parameter, SWEEPS_PER_ACQ gives 
the number of acquisitions. The i’th point will belong to the m’th 
segment where 

m = i modulo (SWEEPSJPER_ACQ) 

will have a value between 0 and SWEEPS_PER_ACQ - 1. 

Then with 
j = i - m 

x [i] = x[j,m] = HORIZJNTERVAL * j + RIS_OFFSET[m] 
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I 



where the RIS_OFFSET’s can be found in the RISTIME array. 
There can be up to 100 8 byte double precision floating point num- 
bers in this block. The instrument tries to get segments with times 
such that 

RIS_OFFSET[i] « PIXEL_OFFSET + (i - 0.5) * HORIZ_IN 

TERVAL 

Thus, taking as an example a RIS with SWEEPS_PER_ACQ = 10 
HORIZ_INTERVAL = 1 ns and PIXEL_OFFSET = 0.0, we might 
find for a particular event that: 

RIS_OFFSET[0] =-0.5 ns RIS_OFFSET[l] = 0.4 ns 

RIS_OFFSET[2] = 1.6 ns RIS_OFFSET[3] = 2.6 ns 

RIS_OFFSET[4] = 3.4 ns RIS_OFFSET[5] = 4.5 ns 

RIS_OFFSET[6] = 5.6 ns RIS_OFFSET[7] = 6.4 ns 

RIS_OFFSET[8] = 7.6 ns RIS_OFFSET[9] = 8.5 ns 

and therefore: 

x[0] = RIS_OFFSET[0] = -0.5 ns 

x[l] = RIS_OFFSET[l] = 0.4 ns 



x[9] = RIS_OFFSET[9] = 8.5 ns 

x[10] = 1 ns * 10 + (-0.5) = 9.5 ns 

xf 11] = 1 ns * 10 + 0.4 = 10.4 ns 



x[19] = 1 ns * 10 + 8.5 = 18.5 ns 

x[20] = 1 ns * 20 + (-0.5) = 19.5 ns 



WAVEFORM COMMAND Waveforms that have been read in their entirety with the WAVE- 
FORM? command can be sent back into the instrument. Since the 
descriptor contains all of the necessary information, you do not 
have to be careful about any of the communication format param- 
eters. The instrument can learn all that it needs to know from the 
waveform. 

If you want to synthesize waveforms for display or comparison pur- 
poses, you are encouraged to read out a waveform of the 
appropriate size and then replace the data with the desired values. 
This will assure that the descriptor is coherent. 

Note: You are only allowed to send back waveforms to memory 
traces (MC or MD for 2~channel instruments or MC, MD, FE 
and FF for 4-channel instruments). This means that you may 
have to remove or change the prefix (Cl or CHANNEL_1 ) in the 
response to the WF? query. The examples for the WF command in 
Section 5 show how this can be done. 
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MORE CONTROL OF 
WAVEFORM QUERIES 



HIGH-SPEED 
WAVEFORM TRANSFER 



There are many different ways for you to use the WAVEFORM? 
command which may simplify or speed up your work. Among 
them are: 

• Partial readout of waveform 

The WAVEFORM_SETUP command allows you to specify a 
short part of a waveform for readout. It also lets you select a spars- 
ing factor to read only every n’th data point. 

• Byte swapping 

The COMM_ORDER command allows you to swap the two bytes 
of a 16-bit word. In fact, byte swapping is done for all numbers 
represented by more than one byte. This is the case for the des- 
criptor, the time blocks, and WORD arrays, thereby simplifying 
data interpretation for some computer systems (e.g. INTEL based, 
or DEC) 

• Data length, block format, and encoding 

The COMM_FORMAT command gives you control over these 
parameters. If you do not need the extra precision of the lower 
order byte of the standard data value, the BYTE option lets you 
save a factor of two on the amount of data to be transmitted or 
stored. If your computer is not able to read binary data, the HEX 
option allows a response form where the value of each byte is given 
by a pair of hexadecimal digits. 

• Data only transfers 

The COMM_HEADER OFF mode will allow you to get a response 
to WF? DAT1 with the data only (the C1:WF DAT1 will disap- 
pear) . 

If you have also specified COMM_FORMAT OFF, BYTE, BIN, 
you will just get a response of data bytes (the #90000nnnnn will 
disappear) . 

• Formatting for RS-232 users 

The COMM_RS232 command can help you by splitting the very 
long WF? response into individual lines 



In order to achieve the maximum continuous data transfer rates 
from the oscilloscope to your instrument you will have to optimize 
many factors. The single most important point is to limit the work 
done in your computer. This means avoiding having to write the 
data to disk, minimizing the per data point computations, minimiz- 
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ing the number of calls to the IO system, etc. You can let the 
instrument help by reducing the number of points to be transferred 
and the number of data bytes per point. The pulse parameter ca- 
pability and the processing functions can save you lots of 
computing and lots of data transfer time if employed creatively. 
Two other very important principles are: 

• Try to overlap waveform acquisition with waveform transfer. The 
oscilloscope is capable of transferring an already acquired or pro- 
cessed waveform after a new acquisition has been started. This can 
also considerably increase the total time that the oscilloscope will 
be able to acquire events if it has to wait for triggers (livetime) . 

• Minimize the number of waveform transfers by using the se- 
quence mode to accumulate many triggers for each transfer. This 
is preferable to using the WAVEFORM_SETUP command to re- 
duce the number of data points to be transferred. It also reduces 
the oscilloscope transfer overhead significantly. 

Here is an example of the type of commands to be given: 

ARM to acquire the first event or sequence 

WAIT;ARM;C1:WF? to wait for the event, start the next acqui- 
sition and then transfer the data. 

This second line can be repeated by your program as soon as it has 
finished reading the waveform. 
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An extensive set of status registers allows the user to quickly deter- 
mine the oscilloscope's internal processing status at any time. The 
status registers as well as the status reporting system have been 
designed to comply with IEEE 488.2 recommendations. 

Related functions are grouped together in common status registers. 
Some, such as the Status Byte Register (STB) or the Standard 
Event Status Register (ESR), are required by the IEEE 488.2 stan- 
dard. However, other registers are device specific. They include 
the Command Error Register (CMR) or the Execution Error Reg- 
ister (EXR). Commands associated with IEEE 488.2 mandatory 
status registers are preceded by an asterisk <*>. 



OVERVIEW OF STATUS 
AND SERVICE REQUEST 

REPORTING Figure 2 shows the organization of the status registers. The central 

reporting structure is the Status Byte Register (STB). It consists of 
8 bits, three of which are not used. 

The Standard Event Status Bit (ESB) and the Internal Status 
Change Bit (INB) in the Status Byte Register are summary bits of 
the Standard Event Status Register (ESR) and the Internal State 
Change Register (INR). The Message Available Bit (MAV) is set 
whenever there are data bytes in the output queue. The Value 
Adapted Bit (VAB) indicates that a parameter value was adapted 
during a previous command interpretation (e.g. if the command 
“TDIV 2.5 US” is received, the time base is set to 2 psec/div and 
the VAB bit is set). 

The Master Summary Status bit (MSS) indicates that the instru- 
ment requests service. The MSS bit can only be set if any of the 
other bits of STB are enabled with the Service Request Enable 
Register (SRE). 

All Enable registers (SRE, ESE and INE) are used to generate a 
bitwise AND with their associated status registers. The logical OR 
of this operation is reported to the STB register. At power-on, all 
Enable registers are zero, inhibiting any reporting to the STB. 

The Standard Event Status Register (ESR) mostly summarizes er- 
rors, whereas the Internal State Change Register (INR) reports 
internal changes in the instrument. Additional details of the errors 
reported by ESR can be obtained with the queries “CMR?”, 
“DDR?”, “EXR?” and “URR?”. 



191 




Logical OR 



y Status Registers 



Power ON 

User request (URR?) 

Command error found CMR?) 
Execution error detected (EXR?) 
Device specific error (DDR?) 
Query error 

Request control (unused) 
Operation complete 
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Function E processing terminated 
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Time-out in a data block transfer 
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Example of status reporting 



Summary 



STATUS BYTE REGISTER 
(STB) 



The register structure contains one more register (not shown in 
Figure 2) . It is the Parallel Poll Enable Register (PRE) which acts 
exactly like the Service Request Enable Register (SRE), but it sets 
the “ist” bit (not shown in Figure 2), used in the Parallel Poll. The 
“ist” bit can also be read with the “*IST?” query. 

If an erroneous remote command, e.g. “TRIG_MAKE SINGLE”, 
is transmitted to the instrument, it rejects the command and sets 
the Command Error Register (CMR) to the value 1 (unrecognized 
command/query header) . The non-zero value of CMR is reported 
to bit 5 of the Standard Event Status Register (ESR) which is then 
set. 

Nothing further happens unless the corresponding bit 5 of the 
Standard Event Status Enable Register (ESE) is set (with the com- 
mand “ *ESE 32”) , enabling the fact that bit 5 of ESR is set to be 
reported to the summary bit ESB of the Status Byte Register 
(STB). 

If setting of the ESB summary bit in STB is enabled, again nothing 
happens unless further reporting is enabled by setting the corre- 
sponding bit in the Service Request Enable Register (with the 
command “*SRE 32”). In this case, the generation of a non-zero 
value of CMR ripples through to the Master Summary Status bit 
(MSS), generating a Service Request (SRQ). 

The value of CMR can be read and simultaneously reset to zero at 
any time with the command “CMR?”. The occurrence of a com- 
mand error can also be detected by analyzing the response to 
“ *ESR?” . However, if several types of potential errors must be 
surveyed, it is usually much more efficient to enable propagation 
of the errors of interest into the STB with the enable registers ESE 
and INE. 

A command error (CMR) sets bit 5 of ESR: 

• if bit 5 of ESE is set, ESB of STB is also set. 

• if bit 5 of SRE is set, MSS/RQS of STB is also set and a 
Service Request is generated. 



The Status Byte Register is the instrument’s central reporting struc- 
ture. The STB is composed of 8 single-bit summary messages (of 
which 3 are unused) which reflect the current status of the asso- 
ciated data structures implemented in the instrument. 

Bit 0 is the summary bit INB of the Internal State Change Register. 
It is set if any of the bits of the INR are set, provided that they are 
enabled by the corresponding bit of the INE register. 
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Bit 2 is the Value Adapted Bit, indicating that a parameter value 
was adapted during a previous command interpretation. 

Bit 4 is the Message Available (MAV) bit, indicating that the in- 
terface output queue is not empty. 

Bit 5 of STB is the summary bit ESB of the Standard Event Status 
Register. It is set if any of the bits of the ESR are set, provided that 
they are enabled by the corresponding bit of the ESE register. 

Bit 6 of the Status Byte Register (STB) is alternatively called the 
Master Summary Status bit (MSS) or the Request for Service bit 
(RQS) because the STB can be read in two different ways. The 
command “*STB?” reads and clears the STB in the query mode, 
in which case bit 6 of the STB is the MSS bit, indicating if the 
instrument has any reason for requesting service. The other way of 
reading the STB is the serial poll (see Section 3, page 22, for the 
GPIB serial poll procedure). In this case, bit 6 of the STB is the 
RQS bit, indicating that the instrument has actually activated the 
SRQ line on the GPIB. The serial poll only clears the RQS bit. 
Therefore, the MSS bit of the STB (and any other bits which 
caused MSS to be set) will stay set after a serial poll. The controller 
must reset these bits. 

The Status Byte Register may be read via the query " *STB?’\ The 
response represents the binary weighted sum of the register bits. 
The register is cleared by “ *STB?”, “ALST?”, “*CLS” or after 
the instrument has been powered up. 



STANDARD EVENT 

STATUS REGISTER (ESR) The ESR is a 16-bit register reflecting the occurrence of events. 

The register bit assignments have been standardized by 
IEEE 488.2. Only the lower 8 bits are currently in use. 

The Standard Event Status Register may be read via the query 
“*ESR?”. The response is the binary weighted sum of the register 
bits. The register is cleared with an “ *ESR?” or “ALST?” query, a 
“*CLS” command or after power-on. 

Example The response message “*ESR 160” indicates that a command er- 

ror occurred and that the ESR is being read the first time after 
power-on. The value 160 can be broken down into 128 (bit 7) 
plus 32 (bit 5). See Table 5, page 82, for a description of the 
conditions corresponding to the bits set. 

The “Power ON” bit appears only on the first “ *ESR?” query after 
power-on because the query clears the register. The type of com- 
mand error can be determined by reading the Command Error 
Status Register with the query “CMR?”, Note that it is not neces- 
sary to read (and simultaneously clear) this register in order to be 
able to set the CMR bit in the ESR on the next command error. 
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STANDARD EVENT 
STATUS ENABLE 
REGISTER (ESE) 



Example 



SERVICE REQUEST 

ENABLE REGISTER (SRE) The Service Request Enable Register specifies which summary 

bit(s) in the Status Byte Register will cause a service request. The 
Service Request Enable Register consists of 8 bits. Setting a bit in 
the register allows the summary bit located at the same bit position 
in the Status Byte Register to generate a service request provided 
that the associated event becomes true. Bit 6 (MSS) cannot be set 
and is always reported as zero in response to the query “*SRE?” . 

The Standard Event Enable Register is modified with the com- 
mand “*SRE”. It is cleared with the command “*SRE 0”, or after 
power-on. It may be read with the query “*SRE?”. 



The ESE allows one or more events in the Standard Event Status 
Register to be reported to the ESB summary bit in the STB. 

The Standard Event Enable Register is modified with the com- 
mand “ *ESE” . It is cleared with the command “ *ESE 0”, or after 
power-on. It may be read with the query “*ESE?” . 

“*ESE 4” sets bit 2 (i.e. binary 4) of the standard event enable 
register, enabling query errors to be reported. 



PARALLEL POLL 

ENABLE REGISTER (PRE) The Parallel Poll Enable Register specifies which summary bit(s) in 

the Status Byte Register will set the “ist” individual local message. 
This register is quite similar to the Service Request Enable Register 
(SRE), but it is used to set the parallel poll “ist” bit rather than 
MSS. 

The value of the “ist” may also be read without a Parallel Poll via 
the query “ *IST?” . The response indicates if the “ist” message has 
been set or not (values are 1 or 0). 

The Parallel Poll Enable Register is modified with the command 
“ *PRE” . It is cleared with the command “*PRE 0”, or after pow- 
er-on. It may be read with the query “*PRE?”. (See Section 3, 
page 23, for the GPIB parallel poll procedure.) 

Example “*PRE 5” sets bits 2 and 0 (decimal 4 and 1) of the Parallel Poll 

Enable Register. 

INTERNAL STATE CHANGE 

STATUS REGISTER (INR) The INR reports the completion of a number of internal opera- 
tions. The events tracked by this 16-bit-wide register are listed 
with the command “INR?” in Section 5. 
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The Internal State Change Status Register may be read via the 
query “INR?”. The response is the binary weighted sum of the 
register bits. The register is cleared with an “INR?” or "ALST?" 
query, a “*CLS" command or after power-on. 



INTERNAL STATE CHANGE 

ENABLE REGISTER (INE) The INE allows one or more events in the Internal State Change 

Status Register to be reported to the INB summary bit in the STB. 

The Internal State Change Enable Register is modified with the 
command “INE”. It is cleared with the command “INE 0”, or 
after power-on. It may be read with the query “INE?”. 



COMMAND ERROR STATUS 

REGISTER (CMR) The Command Error Status register contains the code of the last 

command error detected by the instrument. Command error 
codes are listed with the command “CMR?” in Section 5. 

The Command Error Status Register may be read via the query 
“CMR?”. The response is the error code. The register is cleared 
with a “CMR?” or “ALST?” query, a “*CLS” command or after 
power-on. 



DEVICE DEPENDENT 
ERROR STATUS 

REGISTER (DDR) The DDR indicates the type of hardware errors affecting the in- 

strument. Individual bits in this register report specific hardware 
failures. They are listed with the command “DDR?” in Section 5. 

The Device Dependent Error Status Register may be read via the 
query “DDR?”. The response is the binary weighted sum of the 
error bits. The register is cleared with a “DDR?" or “ALST?” 
query, a “*CLS” command or after power-on. 

EXECUTION ERROR 
STATUS REGISTER 

(EXR) The Execution Error Status Register contains the code of the last 

execution error detected by the instrument. Execution error codes 
are listed with the command “EXR?” in Section 5. 

The Execution Error Status Register may be read via the query 
“EXR?”. The response is the error code. The register is cleared 
with a “EXR?” or “ALST?” query, a “*CLS” command or after 
power-on. 



USER REQUEST STATUS 

REGISTER (URR) The URR contains the identification code of the last menu button 

which was pressed. The codes are listed with the command 
“URR?” in Section 5. 
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The User Request Status Register may be read via the query 
“URR?”. The response is the decimal code associated with the 
selected menu button. The register is cleared with a “URR?” or 
“ALST?” query, a “*CLS” command or after power-on. 
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EXAMPLE 1: 

USE OF THE INTERACTIVE 

GPIB PROGRAM TBIC’ This example assumes the use of an IBM PC, or a compatible comput- 

er, equipped with a National Instruments GPIB interface card. It also 
assumes that the GPIB-driver is left in the default state so that the 
device name “dev4” corresponds to the GPIB address 4 which is as- 
sumed to be the address of the oscilloscope. All text entered by the 
user is underlined. 

ibic<CR> 

program announces itself 

; ibfind<CR> 

enter board/device name: dev4<CR> 

dev4: ibwrt<CR> 

enter string: “tdiv?”<CR> 

[0100] ( cmpl ) 

count: 5 

dev4: ibrd<CR> 

enter byte count: 10<CR> 

[0100] ( cmpl ) 

count: 10 

54 44 49 56 20 35 30 45 T D I V 5 0 E 

2D 39 - 9 

dev4: ibwrt<CR> 

enter string: “cl:cpl?’’<CR> 

[0100] ( cmpl ) 

count: 7 

dev4: ibrd<CR> 

enter byte count: 20<CR> 

[2100] ( end cmpl ) 

count: 11 

43 31 3A 43 50 4C 20 44 C 1 : C P L D 

35 30 0A 5 0 ♦ 

dev4: q<CR> 

for quitting the program 
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EXAMPLE 2: 

GPIB PROGRAM FOR 
IBM PC (HIGH-LEVEL 
FUNCTION CALLS) 



The following BASICA program allows full interactive control of 
the 9420/24/50 using an IBM PC as GPIB controller. It is again 
assumed that the controller is equipped with a National Instru- 
ments GPIB interface card. All the remote control commands 
listed in Section 5 can be used by simply entering the text string of 
the command, i.e. “cl:vdiv 50 mv” (without the quotes) . The pro- 
gram automatically displays the information sent back by the 
oscilloscope in response to queries. 

In addition, a few utilities have been provided for convenience. 
The commands ST and RC enable waveform data to be stored on 
or retrieved from disk if proper drive and file names are provided. 
The command LC returns the oscilloscope to local mode. Re- 
sponses sent back by the oscilloscope are interpreted as character 
strings and are thus limited to a maximum of 255 characters. 

Note 1: It is assumed that the National Instruments GPIB driver 
GPIB.COM is in its default state . This means that the interface 
board can be referred to by its symbolic name *GPIB0 ' and that 
devices on the GPIB with addresses 1 to 16 can be called by the 
symbolic name 'DEVI' to 'DEV16' . 

Note 2: Lines 1-99 are a copy of the file DECL.BAS supplied by 
National Instruments . The first 6 lines are required for the initial - 
ization of the GPIB handler. DECL.BAS requires access to the file 
BIB.M during the GPIB initialization. BIB.M is one of the files 
supplied by National Instruments , and must exist in the directory 
currently in use. 

Note 3: The first 2 lines of DECL.BAS each contain a string 
“XXXXX” which must be replaced by the number of bytes which 
determine the maximum workspace for BASICA (computed by 
subtracting the size of BIB.M from the currently available space in 
BASICA). For example , if the size of BIB.M is 1200 bytes and 
when BASICA is loaded it reports “60200 bytes free ", you would 
replace “XXXXX” by the value 59000 or less. 

Note 4: The default timeout of 10 seconds is modified to 300 msec 
during the execution of this program . However , the default value 
of the GPIB handler is not changed. Whenever a remote command 
is entered by the user , the program sends it to the instrument with 
the function call IBWRT. Afterwards , it always executes an IBRD 
call, independently of whether or not a response is expected. If a 
response is received it is immediately displayed. If there is no re- 
sponse, the program waits until time-out and then asks for the 
next command. 
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1-99 <DECL . BAS> 

100 CLS 

110 PRINT "Control of the 9450 via GPIB and IBM PC" 

115 PRINT "" 

120 PRINT "Options : EX to exit LC local mode" 

125 PRINT " ST store dataRC recall data" 

130 PRINT "» 

140 LINE INPUT "GPIB-address of oscilloscope (1...16)? :",ADDR$ 
145 DEV$ = "DEV" + ADDR$ 

150 CALL IBFIND (DEVS , SC0PE%) 

155 IF SC0PE% < 0 THEN GOTO 830 

160 TMO% = 10 'timeout = 300 msec (rather than default 10 sec) 
165 CALL IBTMO ( SC0PE% , TM0%) 

170 ' 

200 LOOP% = 1 

205 WHILE L00P% 

210 LINE INPUT "Enter command (EX — > Exit) : ",CMDS 



220 


IF 


CMDS = 


"ex" 


OR 


CMD$ 


- "EX" 


THEN 


LOOP% 


= 0 


GOTO 


310 


230 


IF 


CMDS = 


"St" 


OR 


CMDS 


= "ST" 


THEN 


GOSUB 


600 


GOTO 


300 


240 


IF 


CMDS = 


"rc" 


OR 


CMDS 


= "RC" 


THEN 


GOSUB 


700 


GOTO 


300 


250 


IF 


CMDS = 


"lc" 


OR 


CMDS 


= "LC" 


THEN 


GOSUB 


400 


GOTO 


300 


260 


IF 


CMDS = 


XHEN 


GOTO 


300 













270 CALL I BWRT ( SC0PE% , CMDS ) 

275 IF IBSTA% < 0 THEN GOTO 840 

280 GOSUB 500 

300 WEND 

310 GOSUB 400 

320 END 

400 ' 

405 'SUBROUTINE LOCALJMODE 
410 

420 CALL IBLOC ( SCOPE%) 

425 PRINT "" 

430 RETURN 
500 

505 'SUBROUTINE GET_DATA 

510 'If there are no data to read, simply wait until timeout occurs 
515 

520 CALL IBRD ( SC0PE% , RD$ ) 

525 I = IBCNT% ' IBCNT% is the number of characters read 

530 FOR J - 1 TO I 

535 PRINT MID$(RD$, J,l) ; 

540 NEXT J 
545 PRINT "" 

550 RETURN 
600 ' 
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605 ' SUBROUTINE STORE_DATA 

610 

615 RD1$-SPACE$ ( 3 ) 

620 LINE INPUT "Specify trace ( EA , EB , MC , MD , FE , FF , Cl , C2 ) : " , TRACES 

625 LINE INPUT "Enter filename : ", FILES 

630 CMD$="WFSU NP , 0 , SP , 0 , FP , 0 , SN , 0 ; CHDR SHORT" 

640 CALL IBWRT ( SCOPE% , CMD$ ) 

645 CMD$=TRACE$+ " :WF?" 

650 CALL IBWRT ( SCOPE%, CMD$ ) 

660 CALL IBRD ( SCOPE% , RD1$ ) "Discard first 3 chars of response 

665 CALL IBRDF(SCOPE%, FILES) 

670 IF IBSTA% < 0 THEN GOTO 840 
675 PRINT "" 

680 RETURN 
700 

705 ' SUBROUTINE RECALL_DATA 

710 

715 LINE INPUT "Specify target memory (MC , MD) : " , MEMS 

720 LINE INPUT "Enter filename : ", FILES 

730 CMD$=MEM$+" : TRACE ON" 

735 CALL IBWRT ( SCOPE% , CMDS ) 

740 CALL IBWRTF(SCOPE%, FILES) 

745 IF IBSTA% < 0 THEN GOTO 840 
750 PRINT " " 

755 RETURN 
800 ' 

810 y ERROR HANDLER 
820 ' 

830 PRINT "IBFIND ERROR" 

835 END 

840 PRINT "GPIB ERROR — IBERR: " ; IBERR%; "IBSTA: " ; HEXS ( IBSTA%) 

845 END 



EXAMPLE 3: 

GPIB PROGRAM FOR 
IBM PC (LOW-LEVEL 

FUNCTION CALLS) The following example has the same function as example 2, but it is 

written with low level function calls. 

The program assumes that the controller (board) and oscilloscope 
(device) are at addresses 0 and 4 respectively. The decimal listen- 
er and talker addresses of the controller and the device thus are: 

Listener address Talker address 

controller 32 (ASCII <space>) 64 (ASCII @) 

device 32+4=36 (ASCII $) 64+4=68 (ASCII D). 
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1-99 <DECL . BAS> 

100 CLS 

110 PRINT "Control of the 9450 (address 4) via GPIB and IBM PC" 

115 PRINT PRINT "Options : EX to exit LC local mode" 

120 PRINT " ST store data RC recall data": PRINT"" 

125 LOOP=l 

130 CMD1$ = "?_@$" 'Unlisten, Untalk, Board talker, Device listener 
135 CMD2$ = "?_ D" 'Unlisten, Untalk, Board listener, Device talker 
140 BDNAME$= "GPIBO": CALL IBFIND (BDNAMES , BRD0%) 

145 IF BRD0% < 0 THEN GOTO 420 

150 CALL IBSIC (BRD0%) : IF IBSTA% < 0 THEN GOTO 425 
155 WHILE LOOP 

160 LINE INPUT "Enter command (EX — > Exit) : ",CMD$ 

165 V% = 1: CALL IBSRE(BRDO%,V%) 

170 IF CMD$ = "ex" OR CMD$ = "EX" THEN LOOP = FALSE: GOTO 205 

175 IF CMD$ = "St" OR CMD$ = "ST" THEN GOSUB 285 : GOTO 200 

180 IF CMD$ = "rc" OR CMD$ = "RC" THEN GOSUB 365 : GOTO 200 

185 IF CMD$ = "lc" OR CMD$ = "LC" THEN GOSUB 240 : GOTO 200 

190 IF CMD$ = "" THEN GOTO 200 

195 CALL IBCMD (BRD0% , CMD1S ) : CALL IBWRT(BRDO%,CMD$) : GOSUB 270 

200 WEND 

205 CALL IBSIC (BRD0%) : V%=0: CALL IBSRE (BRD0%, V%) 

210 CALL IBSIC (BRD0%) 

215 END 
220 ' 

230 'LOCAL MODE 
235 

240 V% = 0: CALL IBSRE (BRD0%, V%) : PRINT "" 

245 RETURN 
250 

260 'SUBROUTINE GET_DATA 
265 

270 CALL IBCMD ( BRD0%, CMD2$ ) : CALL IBRD (BRDO%, RD$) : I=IBCNT% 

275 FOR J=1 TO I: PRINT MID$ (RD$ , J , 1 ) ; : NEXT J: PRINT "" 

280 RETURN 
285 

290 'SUBROUTINE STORE_DATA 
295 

300 RD1$=SPACE$ ( 3 ) 

305 LINE INPUT "Specify trace (EA,EB,MC,MD,FE,FF,C1,C2) : ", TRACES 

310 LINE INPUT "Enter filename : ".FILES 
315 CALL IBCMD (BRD0%, CMD1S) 

320 CMD$="WFSU NP , 0 , SP , 0 , FP , 0 , SN , 0 ; CHDR SHORT" 

321 CALL IBWRT ( BRD0% , CMDS ) 

325 CMD$=TRACE$+" :WF?" : CALL IBWRT(BRDO%,CMD$) 

330 CALL IBCMD (BRD0%, CMD2S) : CALL IBRD (BRD0%, RD1S) 
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335 CALL IBRDF(BRDO%, FILES) 

340 IF IBSTA% < 0 THEN GOTO 430 
345 PRINT "" 

350 RETURN 
355 ' 

360 'SUBROUTINE RECALL_DATA 
365 

370 LINE INPUT "Specify target memory (MC,MD): ",MEM$ 

375 LINE INPUT "Enter filename : ", FILES 
380 CALL IBCMD (BRDO% , CMD1$ ) 

385 CMD$=MEM$+" : TRACE ON": CALL IBWRT(BRDO%,CMD$) 

390 CALL IBWRTF(BRDO%, FILES) 

395 IF IBSTA% < 0 THEN GOTO 430 
400 PRINT " " 

405 RETURN 
410 

415 'ERROR HANDLER 
420 

425 PRINT "IBFIND ERROR": STOP 

430 PRINT "GPIB ERROR — IBERR : " ; IBERR%; "IBSTA : " ; HEXS ( IBSTA%) 
435 STOP 
440 END 
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THE WAVEFORM 

TEMPLATE This is the response of the instrument to a command of the form 

TMPL? 

TMPL " 

/00 

000000 

; Explanation of the formats of waveforms and their descriptors on the 
; LeCroy Digital Oscilloscopes, 

; Software Release 41.1.1.2, 90/10/04. 

; A descriptor and/or a waveform consists of one or several logical data blocks 
; whose formats are explained below. 

; Usually, complete waveforms are read: at the minimum they consist of 
; the basic descriptor block WAVEDESC 

; a data array block. 

; Some more complex waveforms, e.g. Extrema data or the results of a Fourier 
; transform, may contain several data array blocks. 

; When there are more blocks, they are in the following sequence: 

; the basic descriptor block WAVEDESC 

; the history text descriptor block USERTEXT (may or may not be present) 

; the time array block (for RIS and sequence acquisitions only) 

; data array block 

; auxiliary or second data array block 

; With the exception of the data and time arrays, every block starts with 
; an 8-character name which identifies which kind of block it is. 

; In the following explanation, every element of a block is described by a 
; single line in the form 

; <byte position> cvariable name>: cvariable type> ; <comment> 

; where 

; cbyte position> = position in bytes (decimal offset) of the variable, 

; relative to the beginning of the block. 

; cvariable name> = name of the variable. 

; cvariable type> = string up to 16-character name 

; terminated with a null byte 

; byte 8-bit signed data value 



LECR0Y_2_1 : TEMPLATE 

8 66 109 
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word 

long 

float 



double 



enum 



time_stamp 



data 



text 



16-bit signed data value 

32-bit signed data value 

32-bit IEEE floating point value 

with the format shown below 

31 30 . . 23 22 ... 0 bit position 

s exponent fraction 

where 

s = sign of the fraction 

exponent = 8 bit exponent e 

fraction = 23 bit fraction f 

and the final value is 

(— 1 ) **s * 2** (e-127) * l.f 

64-bit IEEE floating point value 

with the format shown below 

63 62 . . 52 51 ... 0 bit position 

s exponent fraction 

where 

s = sign of the fraction 
exponent = 11 bit exponent e 
fraction = 52 bit fraction f 
and the final value is 
( — 1 ) * * s * 2 ** (e-1023) * l.f 
enumerated value in the range 0 to N 
represented as a 16-bit data value. 

The list of values follows immediately. 

The integer is preceded by an _. 
double precision floating point number, 
for the number of seconds and some bytes 
for minutes, hours, days, months and year. 



double 


seconds 


(0. 


00 


to 59 . 999999) 


byte 


minutes 


(0 


to 


59) 


byte 


hours 


(0 


to 


23) 


byte 


days 


(l 


to 


31) 


byte 


months 


(1 


to 


12) 


word 

word 


year 

unused 


(0 


to 


16000) 



There are 16 bytes in a time field, 
byte, word or float, depending on the 
read-out mode reflected by the WAVEDESC 
variable C0MM_TYPE, modifiable via the 
remote command COMM_FORMAT . 
arbitrary length text string 
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(maximum 400) 

unit_def inition a unit definition consists of a 48 character 

ASCII string terminated with a null byte 
for the unit name. 



WAVEDESC: BLOCK 
> 

; Explanation of the wave descriptor block WAVEDESC; 

i 

i 

< o> DESCRI PT0R_NAME : string ; the first 8 chars are always WAVEDESC 

< 16> TEMPLATE_NAME : string 

< 32> COMM_TYPE: enum ; chosen by remote command COMMJFORMAT 

_0 byte 

_1 word 

endenum 

< 34> COMM_ORDER: enum 

_0 HIFIRST 

_1 LOFIRST 

endenum 

> 

; The following variables of this basic wave descriptor block specify 
; the block lengths of all blocks of which the entire waveform (as it is 
; currently being read) is composed. If a block length is zero, this 
; block is (currently) not present. 



; BLOCKS : 

< 36> 

< 40> 

< 44> 

; ARRAYS : 

l 

< 48> 



WAVE_DESCRI PTOR : long 
USER_TEXT: long 
RES_DESC1 : long 



length in bytes of block WAVEDESC 
length in bytes of block USERTEXT 



TRIGTIME_ARRAY : long 



; length in bytes of TRIGTIME array 
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< 52> 


RIS_TIME_ARRAY: long 


length in bytes of RIS_TIME array 


< S6> 


RES_ARRAY1: long 


an expansion entry is reserved 


< eo> 


WAVE_ARRAY_1 : long 


length in bytes of 1st simple 
data array. In transmitted waveform, 
represent the number of transmitted 
bytes in accordance with the NP 
parameter of the WFSU remote command 
and the used format (see COMMJTYPE) . 


< 64> 


WAVE_ARRAY_2 : long 


length in bytes of 2nd simple 
data array 


< 68> 
< 72> 


RES_ARRAY2: long 
RES_ARRAY3: long 


2 expansion entries are reserved 


; The 


following variables identify the instrument 


< 7 6> 


INSTRUMENT_NAME : string 




< 92> 


INSTRUMENT_NUMBER: long 




< 96> 


TRACE_LABEL: string 


identifies the waveform. 


<112> 

<114> 


RESERVED1: word 
RESERVED2: word 


2 expansion entries 


t 

; The following variables describe the waveform and the time at 
; which the waveform was generated. 


<116> 


WAVE_ARRAY_COUNT : long 


number of data points in the data 
array. If there are two data 
arrays (FFT or Extrema) , this number 
applies to each array separately. 


<120> 


PNTS_PER_SCREEN : long 


nominal number of data points 
on the screen 


<124> 


FIRST_VALID_PNT: long 


count of number of points to skip 



before first good point 
F I RST_V A L I D_POI NT = 0 
for normal waveforms. 
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<128> 


last_valid_pnt: 


long 


index of last good data point 
in record before padding (blanking) 
was started. 

LAST_VALID_POINT = WAVE_ARRAY_COUNT-l 
except for aborted sequence 
and rollmode acquisitions 


<132> 


FIRST_POINT : long 


for input and output, indicates 
the offset relative to the 
beginning of the trace buffer. 

Value is the same as the FP parameter 
of the WFSU remote command. 


<136> 


SPARS I NG_FACTOR : 


long 


for input and output, indicates 
the sparsing into the transmitted 
data block. 

Value is the same as the SP parameter 
of the WFSU remote command. 


<140> 


SEGMENT_INDEX : long 


for input and output, indicates the 
index of the transmitted segment. 
Value is the same as the SN parameter 
of the WFSU remote command. 


<144> 


SUBARRAY_COUNT: 


long 


; for Sequence, acquired segment count, 
; between 0 and NOM_SUBARRAY_COUNT 


<148> 


SWEEPS_PER_ACQ: 


long 


for Average or Extrema, 
number of sweeps accumulated 
else 1 


<152> 


OBSOLETEl: long 






<156> 


VERTI CAL_GAIN : float 




<180> 


VERTICAL_OFFSET: 


float 


; to get floating values from raw data : 

; VERTICAL_GAIN * data - VERTI CAL_OFFSET 


<104> 


max_value: float 




; maximum allowed value. It corresponds 
; to the upper edge of the grid. 


<168> 


MIN_VALUE: float 




; minimum allowed value. It corresponds 
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; to the lower edge of the grid. 



<172> 


NOMINAL_BITS: word 


a measure of the intrinsic precision 
of the observation: ADC data is 8 bit 
averaged data is 10-12 bit, etc. 


<174> 


NOM_SUBARRAY_COUNT: word ; 


for Sequence, nominal segment count 
else 1 


<170> 


HORIZ_INTERVAL: float ; 


sampling interval for time domain 
waveforms 


<180> 


HORI Z_OFFSET : double 


trigger offset for the first sweep of 
the trigger, seconds between the 
; trigger and the first data point 


<188> 


PIXEL_OFFSET: double ; 


; needed to know how to display the 
; waveform 


<196> 


VERTUNIT: unit_def init ion 


; units of the vertical axis 


<244> 


HORUNIT: unit_def init ion 


; units of the horizontal axis 


<292> 

<294> 


RESERVED3 : word 
RESERVED4 : word 


; 2 expansion entries 


<290> 


TRIGGER_TIME: time_stamp ; 


; time of the trigger 


> 

<312> 


ACQ_DURATION: float 


; duration of the acquisition (in sec) 
; in mult i-trigger waveforms. 

; (e.g. sequence, RIS, or averaging) 


<310> 


RECORD__TYPE : enum 





_0 single_sweep 

_1 interleaved 

_2 histogram 

_3 trend 

_4 f ilter_coef f icient 

_5 complex 

__6 extrema 

_7 sequence_obsolete 

endenum 
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<318> processing_done: enum 

_0 nojprocessing 

_1 fir_filter 

_2 interpolated 

_3 sparsed 

_4 autoscaled 

_5 no_result 

_6 rolling 

_7 cumulative 

endenum 

<320> RESERVED5: word ; expansion entry 

<322> RIS_SWEEPS: word ; for RIS, the number of sweeps 

; else 1 

9 

; The following variables describe the basic acquisition 

; conditions used when the waveform was acquired 



TIMEBASE: enum 


_0 


l_ps/div 


_1 


2_ps/div 


_2 


5_ps/div 


_3 


10_ps/div 


_4 


20_ps/div 


_5 


50_ps/div 


_6 


100_ps/div 


_7 


200_ps/div 


_8 


500_ps/div 


_9 


l_ns/div 


_10 


2_ns/div 


_11 


5_ns/div 


_12 


10_ns/div 


_13 


20_ns/div 


_14 


50_ns/div 


_15 


100_ns/div 


_16 


200_ns/div 


_17 


500_ns/div 


_18 


l_us/div 


_19 


2__us/div 


_20 


5_us/div 


_2 1 


10_us/div 


_22 


20_us/div 
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<320> 



<328> 

<332> 



_23 


50_us/div 


_24 


100_us/div 


_25 


200_us/div 


_26 


500_us/div 


_27 


l_ms/div 


-28 


2_ms/div 


-29 


5_ms/div 


_30 


10_ms/div 


_31 


20_ms/div 


_3 2 


50_ms/div 


_33 


100_ms/div 




200_ms/div 


_35 


500_jns/div 


_36 


l_s/div 


_37 


2_s/div 


_3 8 


5_s/div 


_3 9 


10_s/div 


_40 


20_s/div 


_41 


50_s/div 


_42 


100_s/div 


_43 


200_s/div 


_44 


500_s/div 


_45 


l_ks/div 


_46 


2_ks/div 


_ 47 


5_ks/div 


_100 


EXTERNAL 


endenum 


VERT_ 


COUPLING: enum 


_0 


DC_50_Ohms 


_1 


ground 


_2 


DC_lMOhm 


_3 


ground 


_4 


AC,_lMOhm 


endenum 


PROBE 


!_ATT : float 


FIXED 


i_VERT_GAIN: enum 


_0 


l_uV/div 


_1 


2_uV/div 


_2 


5_uV/div 


3 


10_uV/div 
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_4 


20_uV/div 






50_uV/div 




_8 


100_uV/div 




_7 


200__uV/div 




_8 


500_uV/div 




_9 


l_mV/div 




_io 


2_mV/div 




JL1 


5_mV/div 




_1 2 


10_mV/div 




_1 3 


20__mV/div 




_14 


50_mV/div 




_15 


100_mV/div 




_16 


200_mV/div 




-17 


500_mV/div 




_1 8 


l__V/div 




_19 


2_V/div 




-20 


5_V/div 




_21 


10_V/div 




-22 


20_V/div 




_23 


50_V/div 




-24 


100_V/div 




_25 


200_V/div 




_26 


500_V/div 




-27 


l_kV/div 




endenum 


<334> 


BANDWIDTH_LIMIT: enum 




_0 


off 




_1 


on 


endenum 






<336> 


VERTICAL__VERNIER: float 


<340> 


ACQ_ 


VERTJOFFSET: float 


<344> 


WAVE 


_SOURCE: enum 




_0 


CHANNEL_1 




_1 


CHANNEL_2 




_2 


CHANNEL^ 




_3 


CHANNEL_4 




_9 


UNKNOWN 




endenum 
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/OO ENDBLOCK 




USERTEXT: BLOCK 



; Explanation of the descriptor block USERTEXT at most 400 bytes long. 

i 

p 

< o> DESCRIPTOR_NAME: string ; the first 8 chars are always USERTEXT 

< 16 > TEXT: text ; a list of ASCII characters 

/OO ENDBLOCK 



DATA_ARRAY_1 : ARRAY 

; Explanation of the data array DATA_ARRAY_1 . 

; The data item is repeated for each acquired or computed data point 
; of the first data array of any waveform. 

< 0> MEASUREMENT: data ; the actual format of a data is 

; given in the WAVEDESC descriptor 
; by the COMMJTYPE variable. 

/OO ENDARRAY 



DATA_ARRAY_2 : ARRAY 

; Explanation of the data array DATA_ARRAY_2 . 

; The data item is repeated for each acquired or computed data point 
; of the second data array of any dual waveform 
; e.g. the imaginary part of a FFT . 

< 0> MEASUREMENT: data ; the actual format of a data is 

; given in the WAVEDESC descriptor 
; by the COMMJTYPE variable. 

/OO ENDARRAY 
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TRIGTIME: ARRAY 



Explanation of the trigger time array TRIGTIME. 

This data block is repeated for each segment which makes up the acquired 
sequence record. 



< 0 > 



TRIGGER TIME: double 



for sequence acquisitions, 
time in seconds from first 
trigger to this one 



< 8> 



TRIGGER OFFSET: double 



the trigger offset is in seconds 
from trigger to zeroth data point 



/00 



ENDARRAY 



RISTIME: ARRAY 

; Explanation of the random-interleaved-sampling (RIS) time array RISTIME. 

; This data block is repeated for each sweep which makes up the RIS record 

< o> ris_OFFSET : double ; seconds from trigger to zeroth 

; point of segment 

/00 ENDARRAY 



SIMPLE: ARRAY 

; Explanation of the data array SIMPLE. 

; The data item is repeated for each acquired or computed data point 
; of the first data array of any waveform. 

; It is identical to DATA_ARRAY_1 above. 

< o> MEASUREMENT: data ; the actual format of a data is 

; given in the WAVEDESC descriptor 
; by the COMM_TYPE variable. 
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/OO ENDARRAY 



DUAL: ARRAY 

; Explanation of the DUAL array. 

; This data block is repeated for each pair of computed data points 
; composing respectively the first and second data array of a waveform, 
; e.g the real and imaginary parts of an FFT . 



< 0> 


MEASUREMENT^ : 


data 


data in the first data array, 
the actual format of a data is 
given in the WAVEDESC descriptor 
by the COMM_TYPE variable. 


< 0> 


MEASUREMENT_2 : 


data 


data in the second data array 
the byte offset depends on 
the actual format of the data which 
is given in the WAVEDESC descriptor 
by the C0MM_TYPE variable. 


/OO 


ENDARRAY 






000000 


ENDTEMPLATE 
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